Configurar o Omnissa Access para a integração SCIM do Okta

Como primeiro passo para configurar o provisionamento de usuários SCIM do Okta para o Omnissa Access, conclua as tarefas de pré-requisito necessárias no Omnissa Access. Essas tarefas incluem a criação de um cliente OAuth 2.0, a geração de um token OAuth Bearer e a criação de um diretório do tipo Outro.

Algumas dessas tarefas exigem que você use o aplicativo Postman, então baixe e instale o aplicativo de https://www.getpostman.com antes de começar.

Gerenciar cliente OAuth 2.0

No console do Omnissa Access, crie um cliente OAuth 2.0 para a integração SCIM com o Okta.

Quando você cria o cliente, um segredo compartilhado é gerado automaticamente. Depois de criar o cliente, copie o segredo compartilhado. Esse segredo será necessário posteriormente no processo de configuração.

Nota: na versão mais recente do console do Omnissa Access, com a opção Nova Navegação ativada, não é possível inserir sua própria chave secreta compartilhada. Você só pode gerar um segredo compartilhado.

Procedimento

1. Faça login no console do Omnissa Access.

2. Selecione Configurações > Gerenciamento do OAuth 2.0.

3. Na guia Clientes, clique em Adicionar Cliente.

4. Para Tipo de acesso, selecione Token de Cliente de Serviço.

5. No campo ID do cliente, digite um ID, por exemplo, OktaSCIM.

   Certifique-se de seguir as regras de nomenclatura exibidas na página.

6. Em Escopo, marque a caixa de seleção Administrador e, em seguida, selecione a função Administrador do Diretório.

7. Atualize a configuração Acessar vida útil (TTL) do token para um tempo maior que o padrão.

   Importante: definir o Tempo de vida útil (TTL) do token de acesso para um período mais longo é importante porque você precisa atualizar a configuração do Okta com um novo token de portador dentro desse período. Por exemplo, se você escolher um ano, deverá atualizar a configuração do Okta a cada ano com um novo token bearer.

   

8. Clique em Salvar.

   O cliente é criado e um segredo compartilhado é gerado automaticamente.

9. Copie e salve o segredo compartilhado antes de sair da página.

   Importante: depois de sair da página, o segredo compartilhado não estará mais disponível. Se você não copiar o segredo compartilhado antes de sair da página, será necessário regenerar o segredo.

   

Gerar token OAuth Bearer

Após criar o cliente OAuth 2.0 no Omnissa Access, gere um token de portador OAuth.

Pré-requisitos

Baixe e instale o aplicativo Postman. Você pode baixar o Postman em https://getpostman.com.

Procedimento

1. Abra uma nova guia no aplicativo Postman.

2. Para o método HTTP, selecione POST.

3. Para a URL, insira:

   https://tenanturl/SAAS/jersey/manager/api/connectormanagement/otherdirectoryconfigurations
   

   Substitua tenanturl pelo seu URL do Omnissa Access. Por exemplo:

   https://example.workspaceoneaccess.com/SAAS/jersey/manager/api/connectormanagement/otherdirectoryconfigurations
   

4. Clique na guia Autorização e selecione OAuth 2.0 como o tipo.

   

5. Na seção Configurar Novo Token, digite as informações necessárias.

   1. No campo Nome do Token, digite um nome, como por exemplo, WorkspaceONE.

   2. Para Tipo de Concessão, selecione Credenciais do Cliente.

   3. No campo URL do token de acesso, digite*https://tenantURL*/SAAS/auth/oauthtoken, em que tenantURL é a URL do seu locatário do Omnissa Access.

      Por exemplo:

      https://example.workspaceoneaccess.com/SAAS/auth/oauthtoken
      

      Nota: embora este exemplo utilize o nome de domínio workspaceoneaccess.com, o nome de domínio do seu Omnissa Access pode ser diferente. Consulte o artigo 68035 da Base de Conhecimento para obter a lista completa de domínios do Omnissa Access.

   4. No campo ID do cliente, digite o ID do cliente que você definiu em Criar cliente OAuth 2.0.

   5. No campo Segredo do Cliente, digite o segredo gerado em Criar Cliente OAuth 2.0.

      Nota: se você não copiou o segredo ao criar o cliente, poderá gerá-lo novamente. Para regenerar o segredo, acesse Configurações > Gerenciamento de OAuth 2.0 no console do Omnissa Access, selecione o cliente e clique em Regenerar Segredo na página do cliente. Em seguida, copie e cole o segredo aqui.

   6. Para Escopo, digite admin.

   Por exemplo:

   

6. Clique em Obter Novo Token de Acesso.

   Um token é gerado e exibido.

7. Salve o token em um arquivo de texto para uso em uma tarefa posterior.

8. Clique em Usar Token.

9. Para verificar se o token de portador foi adicionado, selecione a guia Cabeçalhos e clique nos cabeçalhos ocultos.

   

   Verifique se o token de portador aparece em uma linha de Autorização.

10. Se o token bearer não foi adicionado, retorne à guia Autorização e selecione o token na lista suspensa Tokens Disponíveis e verifique novamente.

Criar um diretório do tipo Outros no Omnissa Access

Utilize o aplicativo Postman para criar um diretório do tipo Outros no Omnissa Access para seus usuários do Okta.

Procedimento

1. Em Cabeçalhos, defina Content-Type como:

   application/json
   

   Dica: comece a digitar Content-Type na coluna Chave para selecionar a entrada Tipo de Conteúdo.

   

2. Selecione a guia Corpo.

3. Use o seguinte como amostra e clique em Enviar.

   {    
   "type":"OTHER_DIRECTORY",    
   "domains":["OKTA.COM"],    
   "name":"Okta Universal Directory"    
   }
   

   Nota: certifique-se de que seu domínio seja exclusivo no seu locatário.

   Você deverá ver um resultado semelhante ao seguinte: