Configurare i connettori di account

Anteprima — Connettori account

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questo documento descrive come utilizzare le opzioni di configurazione avanzata per i connettori di account Developer Connect.

Un connettore di account è una funzionalità di Developer Connect che ti aiuta a collegare il tuo account Google Cloud al tuo account individuale su un provider di strumenti per sviluppatori non Google. Gli utenti possono specificare il tipo di dati a cui accedere tramite il connettore dell'account selezionando gli ambiti appropriati per quel connettore. Una volta creata una connessione del connettore di account per un'organizzazione, gli utenti all'interno di questa organizzazione possono utilizzare la connessione per autorizzare l'utilizzo dei propri account individuali con la connessione.

Puoi configurare un connettore di account utilizzando un client OAuth preconfigurato di Developer Connect (ad esempio GitHub o GitLab) oppure puoi utilizzare il tuo client OAuth personalizzato (ad esempio un'istanza GitHub Enterprise on-premise).

Prima di iniziare

Accedi al tuo Account Google.

Se non ne hai già uno, registrati per creare un nuovo account.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Developer Connect API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

L'abilitazione di Developer Connect abilita anche l'API Secret Manager.

1. (Facoltativo) Crea una chiave di crittografia gestita dal cliente (CMEK) per criptare i secret di autenticazione creati da Developer Connect.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per creare un connettore di account, chiedi all'amministratore di concederti il ruolo IAM Developer Connect OAuth Admin (roles/developerconnect.oauthAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un connettore di account utilizzando i provider disponibili

I passaggi seguenti descrivono come creare un connettore di account per i provider integrati. Se vuoi creare un connettore dell'account e specificare il tuo client OAuth personalizzato, consulta Creare un connettore dell'account utilizzando un client OAuth personalizzato.

Console Google Cloud

1. Nella console Google Cloud , apri Developer Connect.

   Vai a Developer Connect

2. Seleziona Connettori account.

3. Fai clic su Crea connettore.

4. Seleziona la Regione in cui creare questo connettore dell'account.

5. Assegna un nome al connettore dell'account.

6. Per Tipo di configurazione, scegli Client OAuth preconfigurati.

7. Seleziona il provider OAuth.

8. Scegli se attivare o meno il proxy Developer Connect.

   Con il proxy abilitato, Developer Connect invia comandi Git o effettua chiamate HTTP (o entrambi) al provider per tuo conto. Scopri di più.

9. Seleziona gli ambiti da concedere a Developer Connect per questo connettore dell'account.

   Gli ambiti determinano le azioni che Developer Connect può eseguire nel servizio del provider selezionato. Gli ambiti variano a seconda del provider. Devi selezionare almeno un ambito, a meno che il fornitore non ne abbia.

   A seconda del fornitore, è possibile che non siano disponibili ambiti da selezionare. Potresti riuscire ad aggiungerli manualmente. È anche possibile che siano necessari ambiti.

10. Fai clic su Crea per completare la creazione di questo connettore dell'account.

Google Cloud CLI

Per creare un connettore di account, esegui questo comando:

   gcloud alpha developer-connect account-connectors create my-ac \
       --location=LOCATION \
       --provider-oauth-config-system-id=PROVIDER \
       --provider-oauth-config-scopes=SCOPES \
       --project=PROJECT_ID

In questo comando, sostituisci quanto segue:

• LOCATION con la regione in cui stai creando questo connettore dell'account.

• PROVIDER con il provider SCM a cui ti stai connettendo:

  GITHUB, GITLAB o BITBUCKET_CLOUD.

• PROJECT_ID con l'ID progetto (non il numero di progetto) del progetto in cui stai creando questo connettore di account.

Creare un connettore dell'account utilizzando un client OAuth personalizzato

I passaggi seguenti descrivono come configurare un connettore account per utilizzare un client OAuth specificato. Se vuoi creare un connettore dell'account con i provider integrati, consulta la pagina Creare un connettore dell'account utilizzando i provider disponibili.

Console Google Cloud

1. Nella console Google Cloud , apri Developer Connect.

   Vai a Developer Connect

2. Seleziona Connettori account.

3. Fai clic su Crea connettore.

4. Seleziona la Regione in cui creare questo connettore dell'account.

5. Assegna un nome al connettore dell'account.

6. In Tipo di configurazione, scegli Client OAuth personalizzato.

   La schermata Crea connettore di account mostra un URI di reindirizzamento.

7. Copia l'URI di reindirizzamento.

   L'URI avrà il seguente formato:

   https://developerconnect.google.com/redirect/custom/projects/<project_number>/locations/<location>/accountConnectors/<account_connector_id>

   In questo URI, <project_number> è il numero di progetto, NON l'ID progetto.

8. Crea la tua app personalizzata per il sistema di gestione del controllo della versione scelto utilizzando l'URI di reindirizzamento copiato, poi torna a questo modulo per fornire i dettagli del tuo client OAuth:

   1. Seleziona il fornitore.

   2. Nel campo URI host, fornisci l'URI del tuo sistema di gestione del codice sorgente.

   3. Inserisci l'indirizzo del server di autorizzazione nel campo URI di autorizzazione. Questo indirizzo ha il seguente formato:

      Per GitHub Enterprise: https://<host_name>/login/oauth/authorize Per GitLab Enterprise: https://<host_name>/oauth/authorize Per BitBucket Data Center: https://<host_name>/rest/oauth2/latest/authorize

   4. Nel campo URI token, fornisci l'URI da utilizzare per scambiare un codice di autorizzazione con un token di accesso. Questo indirizzo ha il seguente formato:

      Per GitHub Enterprise: https://<host_name>/login/oauth/access_token Per GitLab Enterprise: https://<host_name>/oauth/access_token Per BitBucket Data Center: https://<host_name>/rest/oauth2/latest/token

   5. Per ID client, fornisci l'ID client della tua app OAuth.

   6. Fornisci il Client secret per autenticare la tua app con il server di autorizzazione.

   7. Se il connettore dell'account utilizzerà il proxy Developer Connect per l'emissione di comandi Git, seleziona Abilita proxy Developer Connect.

   8. Per gli ambiti, seleziona dall'elenco degli ambiti disponibili.

   9. (Facoltativo) Configura il networking e la sicurezza:

      1. Seleziona se questo connettore dell'account utilizzerà internet pubblico o una rete privata.

         Se si tratta di una rete privata, fornisci quanto segue:

         • Il certificato CA da utilizzare

         • Le informazioni per il servizio Service Directory:

         Puoi identificare il progetto per il tuo servizio Service Directory o specificare la regione, lo spazio dei nomi e il nome del servizio.

      2. Attiva o disattiva PKCE per questa app.

         Il tuo servizio OAuth deve supportare PKCE.

   10. Fai clic su Crea per completare la creazione di questo connettore dell'account.

Google Cloud CLI

  ```sh
  gcloud alpha developer-connect account-connectors create my-ac \
    --location=LOCATION \
    --project=PROJECT_ID \
    --custom-provider-oauth-config-system-id=PROVIDER \
    --custom-oauth-config-host-uri= HOST_URI \
    --custom-oauth-config-auth-uri=AUTH_URI \
    --custom-provider-oauth-config-scopes=SCOPES \
    --custom-oauth-config-token-uri=TOKEN_URI \
    --custom-oauth-config-client-id=CLIENT_ID \
    --custom-oauth-config-client-secret=SECRET

  ```

In questo comando, sostituisci quanto segue:

• LOCATION con la regione in cui stai creando questo connettore dell'account.

• PROJECT_ID con l'ID progetto (non il numero di progetto) del progetto in cui stai creando questo connettore di account.

• PROVIDER con il provider SCM a cui ti stai connettendo:

  GITHUB_ENTERPRISE, GITLAB_ENTERPRISE o BITBUCKET_DATA_CENTER.

• HOST_URI con l'URL del sistema di gestione del codice sorgente.

• AUTH_URI con l'URL utilizzato per l'autenticazione al provider SCM scelto.

  Ad esempio:

  • GitHub Enterprise: https://<host_name>/login/oauth/authorize

  • GitLab self-hosted: https://<host_name>/oauth/authorize

  • BitBucket Data Center: https://<host_name>/rest/oauth2/latest/authorize

• SCOPES con un elenco separato da virgole di tutti gli ambiti OAuth del provider che vuoi includere per questo connettore dell'account.

• TOKEN_URI con l'URI da utilizzare per scambiare un codice di autorizzazione con un token di accesso.

• CLIENT_ID con l'ID client della tua app OAuth.

• SECRET con il segreto fornito dal SCMS a cui ti connetti.

Collega il tuo account

Dopo aver creato un connettore account, devi comunque collegare Developer Connect al tuo account con il fornitore prima di poter utilizzare il connettore account.

1. Nella console Google Cloud , apri Developer Connect.

   Vai a Developer Connect

2. Seleziona Connettori account.

   La pagina Connettori account elenca tutti i connettori account presenti nel tuo progetto.

3. Fai clic sul nome del connettore dell'account per cui vuoi collegare l'account del fornitore.

   Viene visualizzata la pagina Dettagli connettore.

4. Fai clic su Collega il tuo account.

   Viene visualizzata una finestra di dialogo di autenticazione OAuth.

5. Fornisci le informazioni nella finestra di dialogo per l'autenticazione presso il tuo fornitore.

6. Fai clic su Autorizza.

Aggiorna un connettore di account

Puoi aggiornare un connettore dell'account esistente, ma puoi aggiornare solo gli ambiti per quel connettore, attivare o disattivare l'impostazione del proxy o entrambe le cose. Se aggiorni gli ambiti per un determinato connettore di account, tutti gli utenti esistenti di quel connettore vengono rimossi.

1. Nella console Google Cloud , apri Developer Connect.

   Vai a Developer Connect

   Developer Connect visualizza la pagina Repository Git.

2. Seleziona Connettori account.

   La pagina Connettori account elenca tutti i connettori account presenti nel tuo progetto.

3. Fai clic sul nome del connettore dell'account da aggiornare.

   Viene visualizzata la pagina Dettagli connettore.

4. Fai clic su Modifica.

5. Dall'elenco Ambiti, seleziona gli ambiti che vuoi consentire per questo connettore dell'account.

6. Fai clic su Salva.

Eliminare un connettore di account

1. Nella console Google Cloud , apri Developer Connect.

   Vai a Developer Connect

   Developer Connect visualizza la pagina Repository Git.

2. Seleziona Connettori account.

   La pagina Connettori account elenca tutti i connettori account presenti nel tuo progetto.

3. Nel menu Altro, seleziona Elimina.

   Viene visualizzata la pagina Dettagli connettore.

4. Fai clic su Modifica.

Passaggi successivi

• Scopri di più sui connettori di account