Todos os sujeitos (um utilizador ou um grupo) seguem um processo de dois passos para acederem ao servidor da API global. Conceda a um sujeito autorizações no servidor da API global
através de IAMRoleBinding a uma IAMRole predefinida. Todas as funções e associações de funções são globais.
Esta página destina-se a públicos-alvo no grupo de administradores da plataforma que gerem autorizações na respetiva organização. Para mais informações, consulte o artigo Públicos-alvo para a documentação isolada do GDC.
Antes de começar
Antes de gerir associações de funções ou revogar o acesso, tem de pedir as autorizações necessárias e preparar o seu ambiente. As funções específicas necessárias dependem da gestão de associações de funções ou da revogação do acesso de utilizadores.
Peça funções do IAM
Contacte o administrador do IAM da organização para pedir as funções com base nas tarefas que tem de realizar:
- Administrador do IAM da organização (
organization-iam-admin): crie, atualize e elimine associações de funções ao nível da organização e do projeto. - Administrador da sessão da organização (
org-session-admin): revogue as sessões ativas e o acesso de um utilizador numa zona específica.
Prepare o seu ambiente
Para usar as ferramentas de linha de comandos para gerir associações de funções ou revogar o acesso, conclua a seguinte configuração.
- Transfira e instale a CLI gdcloud, se ainda não o tiver feito.
- Para usar a API com o
kubectl, é necessária uma configuração adicional:
Configure associações de funções
Pode configurar associações de funções que concedam aos membros da equipa acesso a recursos ao nível da organização ou do projeto.
Atribua uma função a um membro autorizado:
Consola
- Inicie sessão na consola do GDC.
- Selecione uma organização ou um projeto no seletor de âmbito.
- Para configurar associações de funções para uma organização, selecione uma organização.
- Para configurar associações de funções para um projeto, selecione um projeto.
- No menu de navegação, clique em Identidade e acesso > Acesso.
- Clique em Adicionar membro.
- Escolha se quer adicionar utilizadores ou grupos individuais.
- Na lista Fornecedor de identidade, selecione um fornecedor de identidade.
- No campo Nome de utilizador ou alias do grupo , introduza o nome de utilizador, o endereço de email ou o alias.
- Na lista Função, selecione a função que quer atribuir ao utilizador ou ao grupo, como Visualizador da organização ao nível da organização ou Criador de projetos ao nível do projeto.
- Clique em Adicionar.
O membro é apresentado na lista Membro autorizado.
gdcloud
Certifique-se de que tem a CLI gdcloud instalada.
Inicie sessão com o comando
gdcloud auth loginpara se autenticar com o seu fornecedor de identidade. Para mais informações, consulte o artigo Autenticação da CLI gdcloud.Configure associações de funções.
Configure associações de funções para uma organização:
gdcloud organizations add-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLESubstitua as seguintes variáveis:
ORGANIZATION: o nome da organização para a qual está a configurar a associação de funções.USER_ACCOUNT: a conta de utilizador à qual quer conceder a função. Esta sinalização aceita um endereço de email do utilizador com o prefixo do fornecedor de identidade (user:idpprefix-user@example.com) ou um nome da conta de serviço com o projeto da conta de serviço (serviceAccount:projectName:serviceAccountName).ROLE: o nome da função predefinida ou personalizada que quer atribuir ao utilizador.
Configure associações de funções para um projeto:
gdcloud projects add-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLESubstitua as seguintes variáveis:
PROJECT: o nome do projeto para o qual está a configurar a associação de funções.USER_ACCOUNT: a conta de utilizador à qual quer conceder a função. Esta sinalização aceita um endereço de email do utilizador com o prefixo do fornecedor de identidade (user:idpprefix-user@example.com) ou um nome da conta de serviço com o projeto da conta de serviço (serviceAccount:projectName:serviceAccountName).ROLE: o nome da função predefinida ou personalizada que quer atribuir ao utilizador.
API
Exporte a credencial do utilizador que usa:
export GLOBAL_API_SERVER_KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIGExporte a conta de utilizador para a qual quer atribuir a função, incluindo o prefixo do fornecedor de identidade (como
idpprefix-paul@example.com):export USERNAME=IDP_PREFIX-USER_EMAILExporte o nome da função de que o utilizador precisa, como
project-creator. Consulte o artigo Definições de funções para encontrar a função correspondente.export ROLE_NAME=ROLE_NAMEExporte o espaço de nomes onde a associação tem de ser criada:
export BINDING_NAMESPACE=BINDING_NAMESPACESubstitua BINDING_NAMESPACE por
platformpara funções com âmbito na organização ou pelo nome do espaço de nomes do projeto de destino para funções com âmbito no projeto.Consulte o artigo Definições de funções para ver uma lista de funções e o respetivo âmbito.
Crie e aplique um recurso personalizado
IAMRoleBinding:cat <<EOF | kubectl --kubeconfig ${GLOBAL_API_SERVER_KUBECONFIG} apply -f - apiVersion: iam.global.gdc.goog/v1 kind: IAMRoleBinding metadata: name: ${USERNAME}-${ROLE_NAME}-binding namespace: ${BINDING_NAMESPACE} spec: roleRef: apiGroup: iam.global.gdc.goog kind: IAMRole name: ${ROLE_NAME} subjects: - apiGroup: rbac.authorization.k8s.io kind: User name: ${USERNAME} EOF
Remova associações de funções
Quando o acesso já não for necessário, remova um membro e as respetivas funções, autorizações e acesso associados.
Para remover membros, siga os passos abaixo:
Consola
- Inicie sessão na consola do GDC.
- No menu de navegação, clique em Identidade e acesso > Acesso.
- Na lista Membros autorizados, selecione um membro.
- Clique em Remover membro.
- Quando lhe for pedido, clique em Remover membro para confirmar.
gdcloud
Certifique-se de que tem a CLI gdcloud instalada.
Inicie sessão com o comando
gdcloud auth loginpara se autenticar com o seu fornecedor de identidade. Para mais informações, consulte o artigo Autenticação da CLI gdcloud.Remova associações de funções.
Remova associações de funções para uma organização:
gdcloud organizations remove-iam-policy-binding ORGANIZATION \ --member=USER_ACCOUNT \ --role=ROLESubstitua as seguintes variáveis:
ORGANIZATION: o nome da organização da qual está a remover a associação de funções.USER_ACCOUNT: a conta de utilizador da qual quer remover a função. Esta sinalização aceita um endereço de email do utilizador com o prefixo do fornecedor de identidade (user:idpprefix-user@example.com) ou um nome da conta de serviço com o projeto da conta de serviço (serviceAccount:projectName:serviceAccountName).ROLE: o nome da função predefinida ou personalizada que quer remover da conta de utilizador.
Remova associações de funções para um projeto:
gdcloud projects remove-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLESubstitua as seguintes variáveis:
PROJECT: o nome do projeto do qual está a remover a associação de funções.USER_ACCOUNT: a conta de utilizador da qual quer remover a função. Esta sinalização aceita um endereço de email do utilizador com o prefixo do fornecedor de identidade (user:idpprefix-user@example.com) ou um nome da conta de serviço com o projeto da conta de serviço (serviceAccount:projectName:serviceAccountName).ROLE: o nome da função predefinida ou personalizada que quer remover da conta de utilizador.
kubectl
Elimine o IAMRoleBinding para revogar a autorização concedida à conta do PA:
kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG \
delete iamrolebinding USERNAME-ROLE_NAME-binding -n BINDING_NAMESPACE
Substitua o seguinte:
- GLOBAL_API_SERVER_KUBECONFIG: o caminho para o ficheiro kubeconfig para aceder ao servidor da API global.
- USERNAME: a conta de utilizador para a qual quer
remover a função, incluindo o prefixo do fornecedor de identidade (como
idpprefix-paul@example.com). - ROLE_NAME: o nome da função que quer remover,
como
project-creator. - BINDING_NAMESPACE: substitua por
platformpara funções com âmbito na organização ou pelo nome do espaço de nomes do projeto de destino para funções com âmbito no projeto.
Revogue o acesso de utilizadores
Se um membro sair da sua organização ou equipa, pode revogar o respetivo acesso ao Google Distributed Cloud (GDC) air-gapped. A revogação do acesso de um utilizador termina a sessão do mesmo no Distributed Cloud e remove as respetivas funções e autorizações. Também pode ver a atividade e as sessões do utilizador a partir da respetiva hora de início e fim.
Para revogar o acesso de um utilizador num universo do GDC, tem de revogar o acesso de cada zona individualmente. Conclua os seguintes passos para cada zona:
Certifique-se de que tem sessão iniciada na zona para a qual quer revogar o acesso. Por exemplo, defina a configuração do URL zonal para a CLI gdcloud e, em seguida, inicie sessão:
gdcloud config set organization_console_url ZONE_URL gdcloud auth loginSubstitua
ZONE_URLpelo URL da consola do GDC da zona para a qual quer revogar o acesso de utilizadores, que é semelhante ahttps://console.ORG_NAME.ZONE_NAME.ORG_SUFFIX.Para mais informações sobre a mudança de contextos zonais, consulte o artigo Aceda a zonas com as suas ferramentas.
Revogue o acesso do utilizador à zona:
gdcloud admin auth revoke --accounts USER_EMAILSubstitua USER_EMAIL pelo email do utilizador para o qual quer revogar o acesso.
Depois de executar o comando, é apresentada uma saída semelhante à seguinte. Este exemplo revoga o acesso do utilizador
ariel@example.com:Success: NUMBER of sessions revoked for user ariel@example.comNeste exemplo, a variável NUMBER refere-se ao número de sessões ativas que o utilizador tinha.
Confirme que revogou o acesso do utilizador executando novamente o comando
gdcloud admin auth revoke. Se a operação for bem-sucedida, é apresentado o seguinte:No sessions found for account: ariel@example.comRepita os passos anteriores para cada zona no seu universo.