Gestire i provider di autenticazione dell'identità dell'agente

I provider di autenticazione dell'identità dell'agente ti consentono di archiviare e gestire le chiavi API e le credenziali OAuth utilizzate dagli agenti per l'autenticazione presso strumenti e servizi esterni. Nel gestore di autenticazione di Agent Identity, puoi modificare i dettagli dei provider, attivarli o disattivarli oppure eliminarli e ripristinarli in base alle tue esigenze di accesso.

Prima di iniziare

  1. Verifica di aver scelto il metodo di autenticazione corretto.
  2. Verifica di disporre dei ruoli necessari per completare questa attività.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire i provider di autenticazione dell'identità dell'agente, chiedi all'amministratore di concederti il ruolo IAM IAM Connector Editor (roles/iamconnectors.editor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per gestire i provider di autenticazione di Agent Identity. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire i provider di autenticazione Agent Identity sono necessarie le seguenti autorizzazioni:

  • iamconnectors.connectors.update
  • iamconnectors.connectors.delete

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Modifica un provider di autenticazione

Per aggiornare la descrizione o i dettagli di autenticazione di un provider di autenticazione, utilizza la consoleGoogle Cloud o Google Cloud CLI.

Console

  1. Nella console Google Cloud , vai alla pagina Agent Registry.

    Vai ad Agent Registry

  2. Fai clic sul nome dell'agente di cui vuoi gestire il provider di autenticazione.
  3. Fai clic su Identità.
  4. Nella sezione Provider di autenticazione, trova il provider di autenticazione che vuoi gestire.
  5. Per il tuo provider di autenticazione, fai clic sul menu Azioni e seleziona Modifica.
  6. Aggiorna la descrizione o i dettagli di autenticazione in base alle tue esigenze.
  7. Fai clic su Salva.

Google Cloud CLI

  1. Per aggiornare un provider di autenticazione, esegui questo comando:

    gcloud alpha agent-identity connectors update AUTH_PROVIDER_NAME \
        --location="LOCATION" \
        --description="NEW_DESCRIPTION" \
        --three-legged-oauth-client-id="NEW_CLIENT_ID" \
        --three-legged-oauth-client-secret="NEW_CLIENT_SECRET" \
        --three-legged-oauth-authorization-url="NEW_ENDPOINT"

    Sostituisci quanto segue:

    • AUTH_PROVIDER_NAME: il nome del provider di autenticazione.
    • LOCATION: la località del provider di autenticazione.
    • NEW_DESCRIPTION: una nuova descrizione del provider di autenticazione.
    • NEW_CLIENT_ID: un nuovo ID client della tua applicazione di terze parti.
    • NEW_CLIENT_SECRET: un nuovo client secret dalla tua applicazione di terze parti.
    • NEW_ENDPOINT: un nuovo URL del server di autorizzazione di terze parti.

Abilita o disabilita un provider di autenticazione

Se vuoi impedire temporaneamente a un agente di utilizzare un provider di autenticazione senza eliminarlo, puoi disabilitarlo. Puoi riattivarla in qualsiasi momento.

Console

  1. Nella console Google Cloud , vai alla pagina Agent Registry.

    Vai ad Agent Registry

  2. Fai clic sul nome dell'agente di cui vuoi gestire il provider di autenticazione.
  3. Fai clic su Identità.
  4. Nella sezione Provider di autenticazione, trova il provider di autenticazione che vuoi gestire.
  5. Per il tuo provider di autenticazione, fai clic su Azioni e seleziona Abilita o Disabilita.
  6. Nella finestra di dialogo di conferma, fai clic su Attiva o Disattiva.

Google Cloud CLI

  1. Per abilitare un provider di autenticazione, esegui questo comando:

    gcloud alpha agent-identity connectors update AUTH_PROVIDER_NAME \
        --location="LOCATION" \
        --state=enabled
  2. Per disattivare un provider di autenticazione, esegui questo comando:

    gcloud alpha agent-identity connectors update AUTH_PROVIDER_NAME \
        --location="LOCATION" \
        --state=disabled

Sostituisci quanto segue:

  • AUTH_PROVIDER_NAME: il nome del provider di autenticazione.
  • LOCATION: la località del provider di autenticazione.

Elimina un provider di autenticazione

Quando non hai più bisogno di un provider di autenticazione, puoi eliminarlo. L'eliminazione di un provider di autenticazione lo disabilita e lo mette in uno stato di eliminazione temporanea per 30 giorni. Durante questo periodo, puoi ripristinare il provider di autenticazione, se vuoi. Dopo 30 giorni, è necessario un giorno aggiuntivo per l'eliminazione della policy, dopodiché puoi creare un provider di autenticazione con lo stesso nome.

Console

  1. Nella console Google Cloud , vai alla pagina Agent Registry.

    Vai ad Agent Registry

  2. Fai clic sul nome dell'agente di cui vuoi gestire il provider di autenticazione.
  3. Fai clic su Identità.
  4. Nella sezione Provider di autenticazione, trova il provider di autenticazione che vuoi gestire.
  5. Per il tuo provider di autenticazione, fai clic su Azioni e seleziona Elimina.
  6. Nella finestra di dialogo di conferma, fai clic su Elimina.

gcloud

  1. Per eliminare un provider di autenticazione, esegui questo comando:

    gcloud alpha agent-identity connectors delete AUTH_PROVIDER_NAME \
        --location="LOCATION"

Sostituisci quanto segue:

  • AUTH_PROVIDER_NAME: il nome del provider di autenticazione.
  • LOCATION: la località del provider di autenticazione.

Ripristina un provider di autenticazione eliminato

Se elimini per errore un provider di autenticazione, puoi ripristinarlo dallo stato di eliminazione temporanea entro 30 giorni dall'eliminazione. Durante questo periodo, puoi ripristinare il provider di autenticazione, se vuoi. Dopo 30 giorni, è necessario un giorno aggiuntivo per l'eliminazione definitiva della policy, dopodiché puoi creare un provider di autenticazione con lo stesso nome.

Console

  1. Nella console Google Cloud , vai alla pagina Agent Registry.

    Vai ad Agent Registry

  2. Fai clic sul nome dell'agente di cui vuoi gestire il provider di autenticazione.
  3. Fai clic su Identità.
  4. Nella sezione Provider di autenticazione, trova il provider di autenticazione che vuoi gestire.
  5. Per il tuo provider di autenticazione, fai clic su Azioni e seleziona Ripristina.
  6. Nella finestra di dialogo di conferma, fai clic su Ripristina.

gcloud

  1. Per ripristinare un provider di autenticazione, esegui questo comando:

    gcloud alpha agent-identity connectors undelete AUTH_PROVIDER_NAME \
        --location="LOCATION"

Sostituisci quanto segue:

  • AUTH_PROVIDER_NAME: il nome del provider di autenticazione.
  • LOCATION: la località del provider di autenticazione.

Passaggi successivi