Todos os produtos
Search
Central de documentação

Resource Access Management:Provisionar usuários do Okta para o RAM com SCIM

Última atualização: Sep 12, 2026

O protocolo SCIM 2.0 permite provisionar automaticamente usuários do Okta para o Alibaba Cloud RAM.

Pré-requisitos

  • Você tem um administrador do RAM ou um usuário do RAM com permissões para gerenciar aplicativos OAuth.

  • Você tem uma conta de administrador do Okta (Super Administrator).

Informações gerais

  • Criação de usuários: Quando você atribui um usuário ao aplicativo no Okta, o RAM cria automaticamente um usuário do RAM com o mesmo nome de usuário. O RAM substitui o sufixo de domínio do nome de usuário do Okta pelo domínio de usuário do RAM.

  • Atualizações de atributos de usuário: Quando você altera atributos de usuário no Okta, o Okta sincroniza automaticamente as alterações com o usuário do RAM correspondente. Isso depende da habilitação de atualizações automáticas de atributos no Okta. Apenas UserName e DisplayName são compatíveis.

  • Desativação de usuários: Quando você exclui ou desatribui um usuário do aplicativo no Okta, o Okta define o status do usuário como active=false. O RAM não oferece suporte à ativação ou desativação de usuários, portanto o usuário do RAM permanece inalterado.

  • Provisionamento de grupos: A sincronização de grupos do Okta não é compatível.

Etapa 1: Criar e autorizar um aplicativo OAuth

  1. Crie um aplicativo OAuth.

    1. Faça logon no console do RAM.

    2. No painel de navegação à esquerda, escolha Integrations > OAuth (Preview).

    3. Na aba Enterprise Applications, clique em Create Application.

    4. Na página Create Application, defina os parâmetros do aplicativo.

      1. Insira um Application Name e um Display Name.

      2. Em Application Type, selecione Native Application.

      3. Defina o Access Token Validity Period.

      4. Defina o Refresh Token Validity Period.

    5. Clique em Create Application.

  2. Autorize o escopo do aplicativo.

    1. Na aba Enterprise Applications, clique no nome do aplicativo desejado.

    2. Na aba OAuth Scope, clique em Add OAuth Scopes.

    3. No painel Add OAuth Scopes, selecione /acs/scim.

    4. Clique em OK.

  3. Crie um segredo de aplicativo.

    1. Clique na aba App Secrets e depois clique em Create Secret.

    2. Na caixa de diálogo Create Secret, visualize e copie o segredo do aplicativo e clique em close.

      Importante

      O segredo do aplicativo (AppSecretValue) é exibido apenas uma vez. Copie e armazene-o com segurança, pois não será possível recuperá-lo posteriormente.

Etapa 2: Criar um aplicativo no Okta

  1. Faça logon no portal do Okta.

  2. No painel de navegação à esquerda do Okta Admin Console, escolha Applications > Applications.

  3. Na página Applications, clique em Create App Integration.

  4. Na caixa de diálogo Create a new app integration, selecione SAML 2.0 e clique em Next.

  5. Na página General Settings, insira um App name, como AliyunSSODemo, e clique em Next.

  6. Na página Configure SAML, defina as configurações a seguir na seção SAML Settings e clique em Next.

    • Single sign-on URL: Insira o valor de Location registrado na etapa anterior.

    • Audience URI (SP Entity ID): Insira o valor de entityID registrado na etapa anterior.

    • Default RelayState: URL para redirecionar os usuários após o logon SSO. Se deixado em branco, os usuários acessam a página inicial do Alibaba Cloud Management Console.

      Nota

      Por motivos de segurança, o valor de Default RelayState deve ser uma URL em um domínio de propriedade da Alibaba, como *.aliyun.com, *.hichina.com, *.yunos.com, *.taobao.com, *.tmall.com, *.alibabacloud.com ou *.alipay.com. Caso contrário, a configuração será ignorada.

    • Name ID format: Selecione Persistent.

    • Application username: Selecione Email.

  7. Na página Feedback, selecione um tipo de aplicativo e clique em Finish.

Etapa 3: Configurar o provisionamento SCIM no Okta

  1. Ative o provisionamento SCIM.

    1. No aplicativo criado na Etapa 2: Criar um aplicativo no Okta, clique na aba General.

    2. Na seção App Settings, clique em Edit.

    3. Selecione Enable SCIM provisioning e clique em Save.

  2. Configure os parâmetros de conexão SCIM.

    1. Clique na aba Provisioning.

    2. No painel de navegação à esquerda, clique em Integration.

    3. Na seção SCIM Connection, clique em Edit e defina os parâmetros a seguir.

      • SCIM connector base URL: Insira https://scim.alibabacloud.com.

      • Unique identifier field for users: Insira userName.

      • Supported provisioning actions: Selecione Import New Users and Profile Updates e Push New Users.

        Nota

        Push Profile Updates é opcional. Controla se as atualizações de atributos são enviadas automaticamente.

      • Authentication Mode: Selecione OAuth 2.0.

    4. Configure os parâmetros do OAuth 2.0.

    5. Clique em Save.

  3. Obtenha a URL de redirecionamento.

    1. Na aba Provisioning, clique em Integration no painel de navegação à esquerda.

    2. Na parte inferior da página, clique em Authenticate with <App Name>.

    3. Na janela pop-up, copie a URL de redirecionamento.

    4. Faça logon no console do RAM e adicione a URL de redirecionamento ao aplicativo da Etapa 1: Criar e autorizar um aplicativo OAuth no console do RAM.

    5. Retorne à página de configuração no Okta, clique em Authenticate with <App Name> e faça logon no console do Alibaba Cloud para concluir a verificação.

  4. Configure os parâmetros de provisionamento de usuários.

    1. Na aba Provisioning, clique em To App no painel de navegação à esquerda.

    2. Na seção Provisioning to App, clique em Edit.

    3. Na seção Create Users, selecione Enable e clique em Save.

      Nota

      Se você selecionou Push Profile Updates nas configurações de SCIM Connection, selecione também Update User Attributes e defina como Enable.

    4. Na seção <App Name> Attribute Mappings, configure os mapeamentos de atributos. Remova atributos desnecessários e mantenha apenas os seguintes mapeamentos de atributos.

      • Username (userName): O valor é Configured in Sign On settings

      • Given name (givenName): Not mapped

      • Family name (familyName): Not mapped

      • Display name (displayName): O valor é user.login, Apply on é Create and update

    5. Na aba Sign On, clique em Edit.

    6. Defina Application username format como Okta username prefix e clique em Save.

  5. Atribua usuários ao aplicativo.

    1. Na aba Assignments, clique em Assign.

    2. Clique em Assign to People para atribuir usuários ao aplicativo.

Nota

Se ocorrer um erro durante o provisionamento, clique em View Logs para visualizar logs e solucionar o problema.

Verificar o resultado

Após concluir essas etapas, os usuários do Okta são provisionados automaticamente para o RAM. Faça logon no console do RAM e verifique a lista de usuários do RAM. Para usuários provisionados, Synchronization Type é definido como SCIM User Synchronization.