Configurar conectores de conta

Visualização — conectores de conta

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Este documento descreve como usar as opções de configuração avançada para conectores de conta do Developer Connect.

Um conector de conta é um recurso do Developer Connect que ajuda a conectar sua conta do Google Cloud à sua conta individual em um provedor de Ferramentas para desenvolvedores que não é do Google. Os usuários podem especificar o tipo de dados a serem acessados pelo conector de conta selecionando o escopo apropriado para ele. Depois que uma conexão de conector de conta é criada para uma organização, os usuários dessa organização podem usar essa conexão para autorizar o uso das contas individuais com ela.

Antes de começar

Faça login na sua Conta do Google.

Se você ainda não tiver uma, inscreva-se agora.

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

A ativação do Developer Connect também ativa a API Secret Manager.

1. Opcional: crie uma chave de criptografia gerenciada pelo cliente (CMEK) para criptografar os secrets de autenticação criados pelo Developer Connect.

Funções exigidas

Para receber as permissões necessárias para criar conexões e links, peça ao administrador para conceder a você os seguintes papéis do IAM:

• Se você não for o proprietário do projeto: administrador do Developer Connect (roles/developerconnect.admin) na sua conta de usuário.
• Se você planeja usar uma CMEK para criptografar os secrets criados pelo Developer Connect: criptografador/descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypterDecrypter) na conta de serviço do Secret Manager.
• Se você planeja usar a CLI gcloud para concluir as etapas deste guia: papel de administrador do Secret Manager (roles/secretmanager.admin) na conta de serviço do Developer Connect.
• Se você planeja usar o Google Cloud console para concluir as etapas deste guia: administrador de IAM do projeto (roles/resourcemanager.projectIamAdmin) na sua conta de usuário.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.

Observação: quando você tem o papel de administrador de IAM do projeto (roles/resourcemanager.projectIamAdmin), o Google Cloud console pode conceder automaticamente as permissões necessárias em seu nome. Se o administrador não permitir que você tenha o papel de administrador de IAM do projeto, peça a ele para conceder o papel de administrador do Secret Manager (roles/secretmanager.admin) na conta de serviço do Developer Connect (service-{projectNumber}@gcp-sa-devconnect.iam.gserviceaccount.com).

Criar um conector de conta

Para criar um conector de conta, faça o seguinte:

1. No Google Cloud console do, abra o Developer Connect.

   Acessar o Developer Connect

2. Selecione Conectores de conta.

3. Clique em Criar conector.

4. Selecione a região em que você quer criar esse conector de conta.

5. Dê um nome ao conector de conta.

6. Selecione o provedor.

7. Selecione os escopos a serem concedidos ao Developer Connect para esse conector de conta.

   Os escopos determinam quais ações o Developer Connect pode realizar no serviço do provedor selecionado. Os escopos variam de acordo com cada provedor. É necessário selecionar pelo menos um escopo, a menos que o provedor não tenha nenhum.

   Dependendo do provedor, é possível que nenhum escopo esteja disponível para seleção. Você pode adicioná-los manualmente. Também é possível que os escopos sejam obrigatórios.

8. Clique em Criar para terminar de criar esse conector de conta.

Conectar sua conta

Depois de criar um conector de conta, ainda é necessário conectar o Developer Connect à sua conta com o provedor antes de poder usar o conector de conta.

1. No Google Cloud console do, abra o Developer Connect.

   Acessar o Developer Connect

2. Selecione Conectores de conta.

   A página Conectores de conta lista todos os conectores de conta que você tem no seu projeto.

3. Clique no nome do conector de conta para o qual você quer conectar sua conta de provedor.

   A página Detalhes do conector é exibida.

4. Clique em Conectar sua conta.

   Uma caixa de diálogo de autenticação do OAuth é mostrada.

5. Forneça as informações na caixa de diálogo para autenticar seu provedor.

6. Clique em Autorizar.

Atualizar um conector de conta

É possível atualizar um conector de conta, mas só é possível atualizar os escopos dele. Se você atualizar os escopos de um determinado conector de conta, todos os usuários atuais desse conector serão removidos.

1. No Google Cloud console do, abra o Developer Connect.

   Acessar o Developer Connect

   O Developer Connect mostra a página Repositórios Git.

2. Selecione Conectores de conta.

   A página Conectores de conta lista todos os conectores de conta que você tem no seu projeto.

3. Clique no nome do conector de conta que você quer atualizar.

   A página Detalhes do conector é exibida.

4. Clique em Editar.

5. Na lista Escopos, selecione os escopos que você quer permitir para esse conector de conta.

6. Clique em Salvar.

Excluir um conector de conta

1. No Google Cloud console do, abra o Developer Connect.

   Acessar o Developer Connect

   O Developer Connect mostra a página Repositórios Git.

2. Selecione Conectores de conta.

   A página Conectores de conta lista todos os conectores de conta que você tem no seu projeto.

3. No menu Mais, selecione Excluir.

   A página Detalhes do conector é exibida.

4. Clique em Editar.

A seguir

• Saiba mais sobre os conectores de conta