Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Databricks Segreto del client OAuth Principal del servizio
<a name="mes-partner-DatabricksSPSecret"></a>

## Campi con valori segreti
<a name="w2aac27c13c21b3"></a>

Di seguito sono riportati i campi che devono essere contenuti nel segreto di Secrets Manager:

```
{
  "accountId": "{{Databricks account UUID}}",
  "servicePrincipalId": "{{Numeric service principal ID}}",
  "clientId": "{{Service principal application UUID}}",
  "clientSecret": "{{dose followed by the secret value}}",
  "oauthSecretId": "{{Hexadecimal OAuth secret ID}}"
}
```

accountId  
L'ID Databricks del tuo account, che è un UUID.

servizio PrincipalId  
L'ID numerico interno del servizio principale. Questo valore è diverso dall'ID dell'applicazione.

clientId  
L'ID dell'applicazione del principale del servizio. Secrets Manager lo invia come `client_id` nelle richieste OAuth.

Client Secret  
L'attuale segreto del client OAuth. Secrets Manager ruota questo campo.

giuramento SecretId  
L'DatabricksID del segreto OAuth corrente. Secrets Manager lo utilizza per leggere gli ambiti del segreto corrente e per eliminare il segreto che sostituisce.

## Campi di metadati segreti
<a name="w2aac27c13c21b5"></a>

Di seguito sono riportati i campi di metadati per Databricks Service Principal OAuth Client Secret:

```
{
  "adminSecretArn": "arn:aws:secretsmanager:us-east-1:111122223333:secret:{{DatabricksAdminServicePrincipal}}",
  "secretLifetimeDays": "{{730}}"
}
```

amministratore SecretArn  
(Facoltativo) L'Amazon Resource Name (ARN) di un altro segreto di tipo DataBricksspSecret che ruota questo segreto. Ometti questo campo per consentire al responsabile del servizio di ruotare il proprio segreto.

segreto LifetimeDays  
(Facoltativo) La durata di ogni nuovo segreto, espressa in giorni. Il valore deve essere maggiore dell'intervallo di rotazione. Il massimo è 730. Valore predefinito: 730.

## Flusso di utilizzo
<a name="w2aac27c13c21b7"></a>

Questo tipo di rotazione supporta due modalità. In caso di rotazione automatica, il gestore del servizio ruota il proprio segreto. Nella rotazione assistita, un secondo servizio principale lo fa ruotare. Il responsabile del servizio che esegue la rotazione necessita del `account_admin` ruolo, poiché gli endpoint segreti OAuth sono a livello di account.

Puoi creare il tuo segreto utilizzando la [CreateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_CreateSecret.html)chiamata con il valore segreto contenente i campi sopra menzionati e il tipo segreto come DataBricksSPSecret. Le configurazioni di rotazione possono essere impostate utilizzando una chiamata. [RotateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RotateSecret.html) Se si opta per l'autorotazione, è possibile omettere il campo opzionale. `adminSecretArn` È necessario fornire un ruolo ARN nella [RotateSecret](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_RotateSecret.html)chiamata che conceda al servizio le autorizzazioni necessarie per ruotare il segreto. [Per un esempio di politica di autorizzazioni, vedi Sicurezza e autorizzazioni.](mes-security.md)

Durante la rotazione, Secrets Manager richiede un token di accesso utilizzando il flusso di credenziali del client. Crea un segreto sostitutivo che contiene gli ambiti del segreto che sostituisce e archivia il segreto sostitutivo come AWSPENDING. Conferma che il nuovo segreto viene autenticato. Quindi elimina il segreto precedente e promuove AWSPENDING in AWSCURRENT.

Un service principal supporta al massimo cinque segreti OAuth. Se il responsabile del servizio ne possiede già cinque, Databricks rifiuta la richiesta e la rotazione fallisce. Elimina un segreto inutilizzato prima di ruotarlo nuovamente.

Il `account_admin` ruolo richiesto da questo tipo è diverso dall'accesso all'area di lavoro richiesto dalla rotazione del Databricks Personal Access Token. Una singola sovvenzione non copre entrambi i flussi.