Permissões e papéis do IAM

Nesta página, descrevemos os papéis e as permissões do Developer Connect.

O controle de acesso no Developer Connect é feito usando o gerenciamento de identidade e acesso (IAM, na sigla em inglês). Com o IAM, é possível criar e gerenciar permissões para recursos do Google Cloud . O Developer Connect oferece um conjunto específico de papéis predefinidos do IAM, em que cada papel contém um conjunto de permissões adequadas a um tipo específico de acesso ou ação. Recomendamos que você adote o princípio de segurança de privilégio mínimo e conceda apenas o acesso necessário aos recursos.

Papéis predefinidos do Developer Connect

Você atribui permissões às contas por meio do uso de papéis. A tabela a seguir lista os papéis do IAM disponíveis para o Developer Connect e as permissões que eles incluem:

A documentação do IAM inclui uma referência pesquisável de todos os papéis predefinidos.

Role	Permissions
Developer Connect Admin (roles/developerconnect.admin) Full access to Developer Connect resources.	developerconnect.connections.constructGitHubAppManifest developerconnect.connections.create developerconnect.connections.createTagBinding developerconnect.connections.delete developerconnect.connections.deleteTagBinding developerconnect.connections.fetchGitHubInstallations developerconnect.connections.fetchLinkableGitRepositories developerconnect.connections.generateGitHubStateToken developerconnect.connections.get developerconnect.connections.list developerconnect.connections.listEffectiveTags developerconnect.connections.listTagBindings developerconnect.connections.processGitHubAppCreationCallback developerconnect.connections.processGitHubOAuthCallback developerconnect.connections.update developerconnect.gitRepositoryLinks.addPullRequestComment developerconnect.gitRepositoryLinks.addPullRequestReviewComment developerconnect.gitRepositoryLinks.create developerconnect.gitRepositoryLinks.delete developerconnect.gitRepositoryLinks.diffCommit developerconnect.gitRepositoryLinks.fetchCommit developerconnect.gitRepositoryLinks.fetchCommitList developerconnect.gitRepositoryLinks.fetchFileBlame developerconnect.gitRepositoryLinks.fetchGitRefs developerconnect.gitRepositoryLinks.fetchPullRequest developerconnect.gitRepositoryLinks.fetchPullRequestList developerconnect.gitRepositoryLinks.get developerconnect.gitRepositoryLinks.gitProxyRead developerconnect.gitRepositoryLinks.gitProxyWrite developerconnect.gitRepositoryLinks.list developerconnect.gitRepositoryLinks.modifyPullRequest developerconnect.gitRepositoryLinks.openPullRequest developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.* developerconnect.operations.cancel developerconnect.operations.delete developerconnect.operations.get developerconnect.operations.list resourcemanager.projects.get resourcemanager.projects.list
Developer Connect Viewer (roles/developerconnect.viewer) Read-only access to Developer Connect resources.	developerconnect.connections.get developerconnect.connections.list developerconnect.connections.listEffectiveTags developerconnect.connections.listTagBindings developerconnect.gitRepositoryLinks.get developerconnect.gitRepositoryLinks.list developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.get developerconnect.operations.list resourcemanager.projects.get resourcemanager.projects.list
Developer Connect HTTP Proxy Writer ^Beta (roles/developerconnect.connectionHttpProxyWriter) Grants read and write access to connections through the HTTP Proxy.	developerconnect.connections.httpProxyRead developerconnect.connections.httpProxyWrite
Developer Connect Git Proxy Reader (roles/developerconnect.gitProxyReader) Grants read-only access to repositories through the Git Proxy.	developerconnect.gitRepositoryLinks.gitProxyRead
Developer Connect Git Proxy User (roles/developerconnect.gitProxyUser) Grants read and write access to repositories through the Git Proxy.	developerconnect.gitRepositoryLinks.gitProxyRead developerconnect.gitRepositoryLinks.gitProxyWrite
Developer Connect Insights Admin (roles/developerconnect.insightsAdmin) Admin access to Developer Connect Insights resources.	developerconnect.deploymentEvents.* developerconnect.deploymentEvents.get developerconnect.deploymentEvents.list developerconnect.insightsConfigs.* developerconnect.insightsConfigs.create developerconnect.insightsConfigs.delete developerconnect.insightsConfigs.get developerconnect.insightsConfigs.list developerconnect.insightsConfigs.update developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.get developerconnect.operations.list resourcemanager.projects.get resourcemanager.projects.list
Developer Connect Insights Config Agent (roles/developerconnect.insightsAgent) Allow Developer Connect to access SDLC information.	cloudasset.assets.exportResource cloudasset.assets.listResource cloudasset.assets.searchAllResources cloudasset.feeds.create cloudasset.feeds.delete cloudasset.feeds.get cloudasset.feeds.update containeranalysis.occurrences.get containeranalysis.occurrences.list logging.logEntries.create
Developer Connect Insights Viewer (roles/developerconnect.insightsViewer) Read-only access to Developer Connect Insights resources.	developerconnect.deploymentEvents.* developerconnect.deploymentEvents.get developerconnect.deploymentEvents.list developerconnect.insightsConfigs.get developerconnect.insightsConfigs.list developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.get developerconnect.operations.list resourcemanager.projects.get resourcemanager.projects.list
Developer Connect OAuth Admin ^Beta (roles/developerconnect.oauthAdmin) Grants read and write access to AccountConnector resources.	developerconnect.accountConnectors.* developerconnect.accountConnectors.create developerconnect.accountConnectors.delete developerconnect.accountConnectors.fetchUserRepositories developerconnect.accountConnectors.get developerconnect.accountConnectors.gitProxyRead developerconnect.accountConnectors.gitProxyWrite developerconnect.accountConnectors.httpProxyRead developerconnect.accountConnectors.httpProxyWrite developerconnect.accountConnectors.list developerconnect.accountConnectors.update developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.get developerconnect.operations.list developerconnect.providers.list developerconnect.users.* developerconnect.users.delete developerconnect.users.deleteSelf developerconnect.users.fetchAccessToken developerconnect.users.finishOAuth developerconnect.users.getSelf developerconnect.users.list developerconnect.users.startOAuth resourcemanager.projects.get resourcemanager.projects.list
Developer Connect OAuth User ^Beta (roles/developerconnect.oauthUser) Grants read and write access to User resources, and read access to AccountConnectors.	developerconnect.accountConnectors.fetchUserRepositories developerconnect.accountConnectors.get developerconnect.accountConnectors.gitProxyRead developerconnect.accountConnectors.gitProxyWrite developerconnect.accountConnectors.httpProxyRead developerconnect.accountConnectors.httpProxyWrite developerconnect.accountConnectors.list developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.get developerconnect.operations.list developerconnect.users.deleteSelf developerconnect.users.fetchAccessToken developerconnect.users.finishOAuth developerconnect.users.getSelf developerconnect.users.startOAuth resourcemanager.projects.get resourcemanager.projects.list
Developer Connect Read Token Accessor ^Beta (roles/developerconnect.readTokenAccessor) Grants access to Read-Only tokens (both PAT and short-lived). Also grants access to view the git repository link.	developerconnect.connections.get developerconnect.gitRepositoryLinks.fetchReadToken developerconnect.gitRepositoryLinks.get
Developer Connect Token Accessor ^Beta (roles/developerconnect.tokenAccessor) Grants access to Read/Write and Read-Only tokens (both PAT and short-lived). Also grants access to view the git repository link.	developerconnect.connections.get developerconnect.gitRepositoryLinks.fetchReadToken developerconnect.gitRepositoryLinks.fetchReadWriteToken developerconnect.gitRepositoryLinks.get
Developer Connect User (roles/developerconnect.user) Grants access to view the connection and to the features that interact with the actual repository such as reading content from the repository	developerconnect.connections.fetchGitHubInstallations developerconnect.connections.fetchLinkableGitRepositories developerconnect.connections.get developerconnect.connections.list developerconnect.connections.listEffectiveTags developerconnect.connections.listTagBindings developerconnect.gitRepositoryLinks.addPullRequestComment developerconnect.gitRepositoryLinks.addPullRequestReviewComment developerconnect.gitRepositoryLinks.diffCommit developerconnect.gitRepositoryLinks.fetchCommit developerconnect.gitRepositoryLinks.fetchCommitList developerconnect.gitRepositoryLinks.fetchFileBlame developerconnect.gitRepositoryLinks.fetchGitRefs developerconnect.gitRepositoryLinks.fetchPullRequest developerconnect.gitRepositoryLinks.fetchPullRequestList developerconnect.gitRepositoryLinks.get developerconnect.gitRepositoryLinks.list developerconnect.gitRepositoryLinks.modifyPullRequest developerconnect.gitRepositoryLinks.openPullRequest developerconnect.locations.* developerconnect.locations.get developerconnect.locations.list developerconnect.operations.get developerconnect.operations.list resourcemanager.projects.get resourcemanager.projects.list

Service agent roles

Service agent roles should only be granted to service agents.

Role	Permissions
Developer Connect Service Agent (roles/developerconnect.serviceAgent) Gives the Developer Connect API Service Account access to necessary GCP resources. Warning: Do not grant service agent roles to any principals except service agents.	apphub.applications.get apphub.services.get apphub.services.list apphub.workloads.get apphub.workloads.list developerconnect.connections.get developerconnect.connections.httpProxyRead developerconnect.connections.httpProxyWrite developerconnect.gitRepositoryLinks.get developerconnect.operations.get

Conta de serviço do Developer Connect

O Developer Connect usa um agente de serviço para executar tarefas em seu nome ao se comunicar com outros serviços. Esse agente de serviço é criado automaticamente quando você interage pela primeira vez com o Developer Connect (cria uma conexão de repositório ou um conector de conta).

O identificador do agente de serviço do Developer Connect é o seguinte, em que PROJECT_NUMBER é o Google Cloud número do projeto.

service-PROJECT_NUMBER@gcp-sa-devconnect.

Use esse identificador para conceder ou modificar papéis e permissões do IAM.

Configurar o acesso a recursos

Para ver etapas específicas sobre como conceder papéis, consulte Como conceder, alterar e revogar o acesso a recursos.

A seguir

• Saiba mais sobre IAM.
• Conecte-se a um repositório do GitHub.