

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Databricks Persönliches Zugriffstoken
<a name="mes-partner-DatabricksPAT"></a>

## Geheime Wertfelder
<a name="w2aac27c13c19b3"></a>

Die folgenden Felder müssen im Secrets Manager Manager-Geheimnis enthalten sein:

```
{
  "token": "{{dapi followed by 32 hexadecimal characters}}",
  "tokenId": "{{64-character hexadecimal token ID}}",
  "workspaceUrl": "{{https://dbc-xxxxxxxx-xxxx.cloud.databricks.com}}",
  "comment": "{{Comment shown in the token list}}"
}
```

Token  
Das Databricks persönliche Zugriffstoken. Secrets Manager dreht dieses Feld.

Token-ID  
Die Token-ID. Secrets Manager verwendet es, um die Gültigkeitsbereiche des aktuellen Tokens zu lesen und das Token zu widerrufen, das es ersetzt.

Workspace-URL  
Ihre Databricks Workspace-URL, zum Beispiel. `https://dbc-xxxxxxxx-xxxx.cloud.databricks.com` Gib einen reinen HTTPS-Ursprung an. Secrets Manager lehnt eine URL ab, die Benutzerinformationen, einen Port, einen Pfad, eine Abfragezeichenfolge, ein Fragment oder einen abschließenden Schrägstrich enthält.

Kommentar  
(Optional) Der Kommentar, der neben dem Token in der Token-Liste angezeigt wird. Databricks Die maximale Länge beträgt 255 Zeichen.

## Geheime Metadatenfelder
<a name="w2aac27c13c19b5"></a>

Im Folgenden sind die Metadatenfelder für Databricks Personal Access Token aufgeführt:

```
{
  "adminSecretArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:{{DatabricksRotatorToken}}",
  "tokenLifetimeDays": "{{90}}"
}
```

admin SecretArn  
(Optional) Der Amazon-Ressourcenname (ARN) eines anderen Geheimnisses vom Typ DataBricksPat, das dieses Geheimnis rotiert. Lassen Sie dieses Feld weg, damit sich das Token von selbst dreht.

Token LifetimeDays  
(Optional) Die Lebensdauer jedes neuen Tokens in Tagen. Der Wert muss größer als Ihr Rotationsintervall sein. Standard: 90.  
Ein Workspace-Administrator kann eine maximale Token-Gültigkeitsdauer festlegen, die unter dem Wert liegt, den Sie hier auswählen. Wenn das Workspace-Maximum niedriger ist, schlägt die Token-Erstellung fehl und die Rotation kann nicht abgeschlossen werden. Überprüfe die Workspace-Einstellung, bevor du einen Wert auswählst.

## Ablauf der Nutzung
<a name="w2aac27c13c19b7"></a>

Dieser Rotationstyp unterstützt zwei Modi. Bei der Eigenrotation dreht sich das Token von selbst. Bei der unterstützten Rotation wird es von einem zweiten Token desselben Typs gedreht. In beiden Fällen erbt das Ersatztoken die Gültigkeitsbereiche des Tokens, das es ersetzt. Anstatt ein Token mit unterschiedlichen Rechten zu erstellen, schlägt die Rotation fehl, wenn Secrets Manager diese Bereiche nicht lesen kann.

Sie können Ihr Geheimnis mithilfe des [CreateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html)Aufrufs mit dem geheimen Wert, der die oben genannten Felder enthält, und dem Geheimtyp DataBricksPat erstellen. Die Rotationskonfigurationen können mithilfe eines Anrufs festgelegt werden. [RotateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RotateSecret.html) Wenn Sie sich für die Eigenrotation entscheiden, können Sie das optionale `adminSecretArn` Feld weglassen. Sie müssen in dem [RotateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RotateSecret.html)Anruf einen Rollen-ARN angeben, der dem Dienst die erforderlichen Berechtigungen für die Rotation des Secrets gewährt. Ein Beispiel für eine Berechtigungsrichtlinie finden Sie unter [Sicherheit und Berechtigungen](mes-security.md).

Während der Rotation validiert Secrets Manager das aktuelle Token und liest seine Gültigkeitsbereiche. Es erstellt ein Ersatz-Token, das dieselben Gültigkeitsbereiche hat, und speichert den Ersatz als AWSPENDING. Es bestätigt, dass das neue Token authentifiziert wird. Es bestätigt auch, dass die Bereiche, der Besitzer und der `workspaceUrl` des neuen Tokens mit dem Token übereinstimmen, das es ersetzt. Anschließend wird das vorherige Token widerrufen und AWSPENDING auf AWSCURRENT heraufgestuft.

Beide Token authentifizieren sich von dem Moment an, in dem Secrets Manager den Ersatz erstellt, bis er das vorherige Token widerruft. Eine Anwendung, die das Geheimnis in diesem Fenster liest, wird nicht unterbrochen. Der Widerruf selbst ist letztlich konsistent, da Autorisierungsentscheidungen Databricks zwischengespeichert werden. Das vorherige Token wird möglicherweise für einen kurzen Zeitraum weiterhin akzeptiert, nachdem Secrets Manager es widerruft. Wenn Sie aufgrund einer vermuteten Beeinträchtigung der Anmeldedaten wechseln, vergewissern Sie sich, Databricks dass das Token nicht mehr akzeptiert wird.

Databrickswiderruft ein persönliches Zugriffstoken, das 90 Tage lang ungenutzt bleibt. Bei der Rotation wird ein Rotator-Token nur verwendet, wenn es ausgeführt wird. Legen Sie daher ein Rotationsintervall fest, das kürzer als 90 Tage ist. Andernfalls wird das Databricks Rotator-Token wegen Inaktivität zurückgezogen und spätere Rotationen schlagen fehl. Ein Rotationsintervall von 30 Tagen mit der Standardlebensdauer von 90 Tagen erfüllt beide Anforderungen.

Secrets Manager lehnt eine ab`workspaceUrl`, die in eine Loopback-, Link-Local- oder Privatadresse aufgelöst wird. Ein Workspace, den Sie nur über das Front-End erreichen und dessen öffentlicher Zugriff deaktiviert ist AWS PrivateLink, wird daher nicht für die Rotation persönlicher Zugriffstoken unterstützt.