Conceda e revogue o acesso

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.

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

  1. Inicie sessão na consola do GDC.
  2. 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.
  3. No menu de navegação, clique em Identidade e acesso > Acesso.
  4. Clique em Adicionar membro.
  5. Escolha se quer adicionar utilizadores ou grupos individuais.
  6. Na lista Fornecedor de identidade, selecione um fornecedor de identidade.
  7. No campo Nome de utilizador ou alias do grupo , introduza o nome de utilizador, o endereço de email ou o alias.
  8. 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.
  9. Clique em Adicionar.

O membro é apresentado na lista Membro autorizado.

gdcloud

  1. Certifique-se de que tem a CLI gdcloud instalada.

  2. Inicie sessão com o comando gdcloud auth login para se autenticar com o seu fornecedor de identidade. Para mais informações, consulte o artigo Autenticação da CLI gdcloud.

  3. 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=ROLE
      

      Substitua 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=ROLE
      

      Substitua 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

  1. Exporte a credencial do utilizador que usa:

    export GLOBAL_API_SERVER_KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG
    
  2. Exporte 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_EMAIL
    
  3. Exporte 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_NAME
    
  4. Exporte o espaço de nomes onde a associação tem de ser criada:

    export BINDING_NAMESPACE=BINDING_NAMESPACE
    

    Substitua BINDING_NAMESPACE por platform para 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.

  5. 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

  1. Inicie sessão na consola do GDC.
  2. No menu de navegação, clique em Identidade e acesso > Acesso.
  3. Na lista Membros autorizados, selecione um membro.
  4. Clique em Remover membro.
  5. Quando lhe for pedido, clique em Remover membro para confirmar.

gdcloud

  1. Certifique-se de que tem a CLI gdcloud instalada.

  2. Inicie sessão com o comando gdcloud auth login para se autenticar com o seu fornecedor de identidade. Para mais informações, consulte o artigo Autenticação da CLI gdcloud.

  3. 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=ROLE
      

      Substitua 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=ROLE
      

      Substitua 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 platform para 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:

  1. 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 login
    

    Substitua ZONE_URL pelo URL da consola do GDC da zona para a qual quer revogar o acesso de utilizadores, que é semelhante a https://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.

  2. Revogue o acesso do utilizador à zona:

    gdcloud admin auth revoke --accounts USER_EMAIL
    

    Substitua 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.com
    

    Neste exemplo, a variável NUMBER refere-se ao número de sessões ativas que o utilizador tinha.

  3. 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.com
    
  4. Repita os passos anteriores para cada zona no seu universo.