---
sourceDocument: Yokohama Gestão de ativos de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-asset-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de ativos de TI

ft:clusterId :

    - itam

bundleId :

    - itam

workflow :

    - Technology


---

# Integração com Okta

# Integração com Okta {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 min. de leitura

Você pode integrar seu ServiceNowinstância com OktaPara exibir o uso de software para todas as aplicações de SSO conectadas.  
Importante:  
Minimize os riscos de segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.{#integrate-okta__table_box__entry__3}

| Processo | Função de usuário necessária no Oktaaplicação | Escopos de autenticação |
|-|-|-|
| Baixar usuários | Administrador somente leitura | okta.users.read |
| * Grupos de download * Baixar associações de grupo {#integrate-okta__ul_xkf_d4w_dcc} | Administrador somente leitura | okta.groups.read |
| Baixar aplicações | Administrador somente leitura | * okta.apps.read * okta.logs.read {#integrate-okta__ul_ovq_zsc_sbc} |
| Conectar aplicações | Administrador somente leitura | okta.logs.read |
| Atualizar aplicações conectadas | Administrador somente leitura | * okta.apps.leitura * okta.logs.read {#integrate-okta__ul_o35_2tc_sbc} |
| Recuperar assinaturas | Administrador da aplicação | okta.apps.manage |
[Tabela 1. Permissões mínimas do usuário]

{#integrate-okta__box-title}

## Crie um Oktaaplicação {#ariaid-title2}

Crie um Oktaaplicação que você pode integrar ao Now Platform.

### Antes de Iniciar

OktaFunção necessária: Consulte [Permissões mínimas do usuário](https://servicenow-prod.fluidtopics.net/9DpnbYf7xY~MbNA9kWGn4Q#integrate-okta "Você pode integrar seu ServiceNowinstância com OktaPara exibir o uso de software para todas as aplicações de SSO conectadas.")tabela.

Consulte [Permissões e funções de administrador](https://help.okta.com/en/prod/Content/Topics/Security/administrators-admin-comparison.htm)para obter mais detalhes sobre Oktafunções de administrador e. [Escopos e endpoints compatíveis](https://developer.okta.com/docs/guides/implement-oauth-for-okta/scopes/)para obter mais detalhes sobre OktaEscopos de OAuth.

### Procedimento

1. Em um navegador da web, faça login no [Console do administrador do Okta](https://login.okta.com/).
2. Crie um OktaAplicação com funcionalidade OAuth 2,0.  
   Consulte [Crie um app OAuth 2,0 para Okta](https://developer.okta.com/docs/guides/implement-oauth-for-okta/create-oauth-app/)para obter instruções detalhadas.  
   Lembre-se dos seguintes pontos ao criar seu Oktaaplicação:
   * Em URI de redirecionamento de login e. URI de redirecionamento de logout campos, insira <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do </kbd>, em que \> <var class="keyword varname">nome da instância </var>\> é o nome do seu ServiceNowinstância.
   * Copie os valores em ID do cliente e. Segredo do cliente campos. Salve-os em um local seguro para uso posterior.
   * Conceda os escopos a seguir ao seu OktaAplicação do OAuth 2,0:  
     * okta.groups.read
     * okta.apps.read
     * okta.users.read
     * okta.logs.read
     * okta.apps.manage
     {#create-okta-app__ul_v5x_5px_msb}
   * Selecione Token de atualização em Cliente agindo em nome de um usuário Tipo de concessão no portal Okta.
   {#create-okta-app__ul_wym_1st_hnb}

## Crie um Oktaperfil de integração {#ariaid-title3}

Crie um Oktaperfil de integração no seu ServiceNowinstância.

### Antes de Iniciar

Para criar um Oktaperfil de integração, solicite o. Gestão de ativos de software- Gestão de licenças de SaaSplug-in (sn_sam_saas_int) do [ServiceNow Store](https://store.servicenow.com/).

ServiceNow Função necessária: sam_integrator ou admin  
Importante:  
Você deve selecionar Okta spoke caixa de seleção desta integração ao instalar recursos opcionais no [Application Manager](https://www.servicenow.com/docs/access?context=application-manager&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US)página. Para obter mais informações sobre como escolher as aplicações SaaS necessárias, consulte [Solicitação Gestão de licenças de SaaS](https://servicenow-prod.fluidtopics.net/yYI1CnWl12Ncssjqd3facg "Solicite o. Gestão de ativos de software- Gestão de licenças de SaaSplug-in (sn_sam_saas_int) para que você possa criar e gerenciar integrações com o. SaaSE login único (SSO). Você pode usar essas integrações para rastrear o uso de licenças e recuperar licenças não utilizadas.").

### Por Que e Quando Desempenhar Esta Tarefa

Nota:  
A partir da versão 7.0.0 de Gestão de ativos de software- Gestão de licenças de SaaSe a versão 4.1.2 do Oktafalou, seu ServiceNowa instância cria um separado Oktaconexão para cada Oktaperfil de integração que você cria. Cada conexão é executada independentemente uma da outra, o que permite que sua instância ofereça suporte a várias conexões independentes Oktaperfis de integração.

Se você estiver usando Espaço para ativos de software, a opção para criar o. Oktaperfil de integração em IU principalestá inativo.

### Procedimento

1. Navegue até o perfil de integração.

   | Interface | Ação |
   | IU principal | 1. Navegar até TudoAtivo de SoftwareLicença de SaaSPerfis de integração SSO. 2. Selecione Novo. 3. Selecione Perfil de integração do Okta . {#create-integration-profile-okta__ol_dqg_qnx_qtb} |
   | Espaço de ativos de software | 1. Navegar até Operações de licençaAssinaturas de UsuárioPerfis de Integração SSO. 2. Selecione Novo. 3. Selecione Okta na lista suspensa. 4. Selecione Continuar. {#create-integration-profile-okta__ol_jqg_qnx_qtb} |
   |-|-|

   {#create-integration-profile-okta__choicetable_fcx_4nx_qtb}
2. No formulário, preencha os campos.  
   {#create-integration-profile-okta__table_d1s_gp2_2nb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome de exibição | Nome do perfil de integração. Por exemplo, <kbd class="ph userinput">Integração do Okta </kbd>. |
   | Status | Status do perfil de integração. * Se você não tiver publicado o perfil de integração, este campo será definido automaticamente como Rascunho . * Se você já tiver publicado o perfil de integração, este campo será definido automaticamente como Publicado . {#create-integration-profile-okta__ul_dxn_mmt_hzb} |
   | Integração de diretórios | Uma referência ao perfil de integração de diretórios, que é usado para extrair os usuários, grupos e associações de grupo do Active Directory de uma organização. * Se for um registro de integração de diretório para Oktaexiste, você pode selecionar o registro existente. * Se for um registro de integração de diretório para Oktanão existe, um novo registro é criado quando você salva ou envia este formulário. {#create-integration-profile-okta__ul_vxj_cmj_lzb} |
   | Tipo de perfil | Tipo do perfil de integração. Este campo é definido automaticamente como Okta . |
   | Conexão e Credencial | Referência ao alias de conexão e credencial usado no diretório e na integração SSO. * Se existir um registro de integração de diretório e você selecioná-lo no campo Integração de diretório, este campo será definido automaticamente como o alias de conexão e credencial do registro de integração de diretório. * Se um valor de integração de diretório não existir, este campo será preenchido automaticamente. {#create-integration-profile-okta__ul_wnv_vlj_lzb} |
   | Criar assinaturas do Okta | Opção para criar um perfil de integração direta para exibição Oktaassinaturas após a publicação deste perfil de integração. Valor padrão: falso |
   [Tabela 2. Formulário de perfil de integração SSO]

   {#create-integration-profile-okta__table_d1s_gp2_2nb}
3. Na seção Configuração do processo, exiba as funções de usuário ou permissões de API necessárias para minimizar os riscos de segurança e otimizar SaaSlicenças.  
   Nota:  
   Para obter mais informações sobre as funções e escopos necessários, consulte [Permissões mínimas do usuário](https://servicenow-prod.fluidtopics.net/9DpnbYf7xY~MbNA9kWGn4Q#integrate-okta "Você pode integrar seu ServiceNowinstância com OktaPara exibir o uso de software para todas as aplicações de SSO conectadas.")tabela.
   * . Baixar aplicações, usuários e grupos a caixa de seleção está marcada por padrão e você não pode desmarcá-la.

   * . Atividade de download a caixa de seleção está marcada por padrão. Se você limpar, a última atividade das aplicações conectadas não será extraída.
   * . Recuperar assinaturas a caixa de seleção está marcada por padrão. Se você não quiser recuperar assinaturas, desmarque esta caixa de seleção. Se você limpar, os candidatos à remoção serão criados, mas o subfluxo de recuperação de assinatura não será acionado ou o processo de recuperação não será iniciado.

   {#create-integration-profile-okta__ul_nmd_wsd_xcc}
4. Selecione Enviar.  
   . Conexão e credencial o campo é definido automaticamente como sn_okta_spoke.okta_apps_users_groups_activity_and_reclaim .
5. Abra a caixa de diálogo Criar conexão e credencial.

   | Interface | Ação |
   | IU principal | Selecione Criar nova conexão e credencial Link relacionado no formulário de perfil de integração SSO. |
   | Espaço de ativos de software | 1. Selecionando o ícone de visualização ( ![Ícone de visualização.]()) ao lado de Conexão e credencial campo 2. Selecione Abrir registro na visualização do registro. 3. No formulário Aliases de conexão e credencial, selecione Criar nova conexão e credencial link relacionado. {#create-integration-profile-okta__ol_qww_kmj_lzb} |
   |-|-|

   {#create-integration-profile-okta__choicetable_oww_kmj_lzb}
6. Na caixa de diálogo, preencha os campos.  
   {#create-integration-profile-okta__table_qc4_rq2_2nb__entry__2}

   | Campo | Descrição |
   |-|-|
   | Nome | Nome da conexão. Por exemplo, <kbd class="ph userinput">Conexão Okta </kbd>. |
   | URL de conexão | URL da conexão. Insira <kbd class="ph userinput">https:// <var class="keyword varname">SeuOktaDomain </var>&gt;.com </kbd>, em que \> <var class="keyword varname">SeuOktaDomain </var>\> é o domínio da sua organização. |
   | URL de Autorização | URL do endpoint de autorização do OAuth. Insira <kbd class="ph userinput">https:// <var class="keyword varname">SeuOktaDomain </var>&gt;.com/oauth2/v1/authorize </kbd>, em que \> <var class="keyword varname">SeuOktaDomain </var>\> é o domínio da sua organização. |
   | URL de Token | URL do endpoint OAuth que recupera e atualiza tokens de acesso. Insira <kbd class="ph userinput">https:// <var class="keyword varname">SeuOktaDomain </var>&gt;.com/oauth2/v1/token </kbd>, em que \> <var class="keyword varname">SeuOktaDomain </var>\> é o domínio da sua organização. |
   | URL de revogação do token | URL do endpoint OAuth que revoga tokens de acesso. Insira <kbd class="ph userinput">https:// <var class="keyword varname">SeuOktaDomain </var>&gt;.com/oauth2/v1/revogar </kbd>, em que \> <var class="keyword varname">SeuOktaDomain </var>\> é o domínio da sua organização. |
   | ID do cliente do OAuth | ID do cliente atribuído ao seu Oktaaplicação. |
   | Segredo do cliente do OAuth | Segredo do cliente atribuído ao seu Oktaaplicação. |
   | URL de redirecionamento do OAuth | URL do provedor OAuth para o qual os usuários são redirecionados após a autenticação. Este campo é definido automaticamente como https://\<instance-name\>.service-now.com/oauth_redirect.do , em que \> <var class="keyword varname">nome da instância </var>\> é o nome do seu ServiceNowinstância. |
   [Tabela 3. Caixa de diálogo Criar conexão e credencial]

   {#create-integration-profile-okta__table_qc4_rq2_2nb}
7. Selecione Criar e obter um Token do OAuth.  
   Nota:  
   Para obter a função necessária para executar esta etapa, consulte [Permissões mínimas do usuário](https://servicenow-prod.fluidtopics.net/9DpnbYf7xY~MbNA9kWGn4Q#integrate-okta "Você pode integrar seu ServiceNowinstância com OktaPara exibir o uso de software para todas as aplicações de SSO conectadas.")tabela.
8. Em Oktalogin no portal, insira seu Oktae selecione Entre .  
   Nota:  
   Você deve fazer login usando as mesmas credenciais das funções Superadministrador, administrador de aplicações ou administrador de gestão de acesso à API.  
   A caixa de diálogo é fechada e você retorna automaticamente para o formulário Perfil de integração SSO.
9. Selecione Salvar.
10. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.
11. Depois que a conexão for verificada, selecione Publicar .
12. Na caixa de diálogo Confirmação de publicação, selecione OK .  
    Se você limpar Atividade de download após a publicação do perfil de integração, você deve revalidar as conexões porque ocorrem os seguintes eventos:
    * . Valide a conexão o botão aparece no formulário.
    * A última atividade para usuários das aplicações conectadas não foi mais extraída.
    {#create-integration-profile-okta__ul_gj1_tz3_pdc}

### Resultado

Os trabalhos agendados e os trabalhos de diretório baixam uma lista de todas as aplicações, usuários, grupos e assinaturas de software associadas ao Oktaaplicação. Exiba o status do seu trabalho no Resultados de trabalhos agendados e. Resultados do trabalho de diretório do seu perfil de integração. Gestão de ativos de softwareCria automaticamente modelos de software para aplicações com um ID de catálogo externo que corresponde a um Identificador Na tabela Definições de produto de assinatura \[samp_sw_subscription_product-definition\].

### O que Fazer Depois

Se você selecionou Criar assinaturas do Okta e este perfil de integração for publicado, um perfil de integração direta para Oktacriado. Você pode navegar até o perfil de integração direta selecionando Perfil de integração direta link na mensagem informativa.

Depois de navegar até o perfil de integração direta, você poderá exibir Oktaselecionando Assinaturas de software . Para obter mais informações, consulte [Okta Perfil de integração direta de SSO](https://servicenow-prod.fluidtopics.net/9DpnbYf7xY~MbNA9kWGn4Q#okta-direct-int-profile "OktaO perfil de integração direta de SSO ajuda você a gerenciar Oktalicenças de usuário criando assinaturas para Oktausuários ao configurar um OktaIntegração de SSO.").  
Aviso:  
Quando seu token OAuth expirar, seu OktaO perfil de integração exibe uma mensagem de erro indicando que você deve obter um novo token OAuth. Selecione o link na mensagem de erro para obter o novo token OAuth.

Não exclua o registro de credencial do OAuth 2,0 associado ao registro de conexão do Oktaperfil de integração. Se você excluir o registro de credencial do OAuth 2,0, não será possível obter um novo token do OAuth depois que o token atual do OAuth expirar.

Depois de publicar o perfil de integração e conectar aplicações ao perfil, você pode exibir eventos realizados por usuários individuais até 60 dias antes da data atual. Para obter mais informações, consulte [Revise uma regra de recuperação de software](https://servicenow-prod.fluidtopics.net/VgyB0r_qG7JPagR7GMiDRA "Use regras de recuperação para cancelar assinaturas de usuário que têm atividade limitada a nenhuma.").

## Okta Perfil de integração direta de SSO {#ariaid-title4}

OktaO perfil de integração direta de SSO ajuda você a gerenciar Oktalicenças de usuário criando assinaturas para Oktausuários ao configurar um OktaIntegração de SSO.
{#okta-direct-int-profile__table_xhh_slg_hzb__entry__2}

| Campo | Descrição |
|-|-|
| Nome de exibição | Nome do perfil de integração. |
| Status | Status do perfil de integração. Este campo é definido automaticamente como Publicado . |
| Tipo de perfil | Tipo de perfil de integração. Este campo é definido automaticamente como Assinatura do Okta . |
| Baixar subfluxo de assinatura |   |
| Subfluxo | Este campo é definido automaticamente como Okta Baixar assinaturas . |
[Tabela 4. Perfil de integração direta de SSO do OKTA]

{#okta-direct-int-profile__table_xhh_slg_hzb}

## Conectar aplicações SSO {#ariaid-title5}

Conete uma aplicação SSO para monitorar todos os usuários e grupos que têm acesso a essa aplicação. Você também pode rastrear dados de login do usuário e recuperar licenças não usadas.

### Antes de Iniciar

ServiceNow Função necessária: sam_integrator ou admin

### Por Que e Quando Desempenhar Esta Tarefa

ServiceNow® Gestão de licenças de SaaS oferece integrações diretas com algumas aplicações. As integrações diretas fornecem os dados de uso mais abrangentes. Para obter uma lista de integrações diretas disponíveis, consulte [Integre com aplicações SaaS](https://servicenow-prod.fluidtopics.net/9YzERC0yKl0F1GqiSDC4Jw "Crie um perfil de integração para exibir informações de uso de software e otimizar licenças obsoletas.").

Se você já tiver criado uma integração direta para uma aplicação, conectar a mesma aplicação em uma integração SSO criará registros de assinatura duplicados no ServiceNowinstância. Você só deve usar a integração direta. Se você conectar uma aplicação em uma integração SSO, mas quiser criar uma integração direta para essa aplicação, desconecte a aplicação antes de criar a integração direta.

### Procedimento

1. Navegar até TudoLicença de SaaSAplicações de SSO.
2. Selecione a aplicação que você deseja conectar.
3. . Modelo de software o campo está vazio, adicione um modelo de software para a aplicação.  
   Para que você possa conectar uma aplicação, ela deve ser associada a um modelo de software. ServiceNow® Gestão de ativos de softwareCria automaticamente modelos de software para aplicações com um ID de catálogo externo que corresponde a um Identificador Na tabela Definições de produto de assinatura \[samp_sw_subscription_product_definition\]. Para todas as outras aplicações, você pode criar um modelo de software manualmente. Para obter instruções detalhadas, consulte [Crie modelos de software em Gestão de ativos de softwareclássico](https://servicenow-prod.fluidtopics.net/1NEfB7eznFM5zwRaBj2~Eg "Crie um modelo de software para adicionar detalhes do produto que são usados para conectar direitos de software adquiridos com instalações de software descobertas em seu sistema.").
4. Selecione a data em que você deseja analisar a última atividade em Analise a última atividade de campo.  
   Você pode começar a analisar dados de login de usuários individuais e aplicações a partir da data atual ou de até 60 dias antes. O valor padrão é 30 dias. Se você selecionar uma data anterior à data atual, pode levar mais tempo para que os resultados apareçam devido à quantidade de dados que você deseja analisar.

   Depois de enviar um valor no Analise a última atividade de , o campo se torna somente leitura.
5. Selecione Conectar.  
   Dica:  
   Para conectar várias aplicações simultaneamente, marque a caixa de seleção de cada aplicação que você deseja conectar na lista de aplicações SSO. Selecione as ações no menu de linha selecionado e selecione Conectar . Se alguma aplicação não estiver associada a um modelo de software, o nome do Conectar o item de menu é atualizado para indicar que somente algumas das aplicações serão conectadas. Por exemplo, A. Conectar (1 de 4) o item de menu indica que apenas 1 dos quatro apps selecionados serão conectados. Adicione modelos de software às aplicações restantes para prosseguir com as conexões.
{#connect-okta-apps__steps_yhg_2x2_2nb}

### O que Fazer Depois

Depois que a aplicação SSO se conectar, seu ServiceNowa instância cria automaticamente usuários, grupos, assinaturas e regras de recuperação que são atualizadas diariamente. Se você excluir um usuário, aplicação, grupo ou associação de grupo do OktaConsole do desenvolvedor, as mudanças são refletidas em seu ServiceNowinstância.

Revise todas as regras de recuperação geradas automaticamente para garantir que elas atendam às suas especificações para recuperar assinaturas de usuário. Para obter mais informações, consulte [Revise uma regra de recuperação de software](https://servicenow-prod.fluidtopics.net/VgyB0r_qG7JPagR7GMiDRA "Use regras de recuperação para cancelar assinaturas de usuário que têm atividade limitada a nenhuma.").

Crie direitos de software para os modelos de software gerados automaticamente para rastrear o software usado em relação ao software próprio. Para obter mais informações sobre como criar direitos de software no Gestão de ativos de softwareaplicação clássica, consulte [Crie direitos em Gestão de ativos de softwareclássico](https://servicenow-prod.fluidtopics.net/wvUP39nC3GSpHYfw~oagRg "Crie direitos no Gestão de ativos de softwareaplicação clássica para gravar os detalhes da sua licença e alocar direitos de software adquiridos para usuários ou dispositivos."). Para obter mais informações sobre como criar direitos de software no Espaço de ativos de software, consulte [Crie direitos no espaço](https://servicenow-prod.fluidtopics.net/9M4OpOX2IQukgpQ7eT~bVw "Crie atribuições no Software Asset Workspace para inserir os detalhes da licença e alocar direitos de software comprados para usuários ou dispositivos."). Para obter mais informações sobre como criar direitos de software usando o. Gestão de ativos de softwarePlaybook, consulte [Crie direitos usando o passo-a-passo guiado](https://servicenow-prod.fluidtopics.net/xsjN17LVbR0hE~BwBhy4Cw "Use o playbook guiado com passo a passo para um processo passo a passo de criação de direitos.").

A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir seus resultados de reconciliação no [Workbench de licença](https://servicenow-prod.fluidtopics.net/1nnUed7YT2WIb2E8m9ROAw "Revise os resultados de reconciliação em uma exibição simplificada do workbench.")( Gestão de ativos de softwareaplicação clássica) ou o. [Exibição de uso de licença](https://servicenow-prod.fluidtopics.net/Z~KV_h0HfjerR7dhNx2hLg "Use a exibição de uso de licença como um plano único para entender a posição da licença de todos os produtos de software, corrigir não conformidade, exibir resultados de reconciliação, exibir ou adicionar candidatos à remoção e exibir Gestão de ativos de softwarerelatórios relacionados.")(Espaço de ativos de software). Use estes resultados para determinar sua posição de conformidade de licença e corrigir qualquer não conformidade. Para obter mais informações sobre como executar reconciliação no Gestão de ativos de softwareaplicação clássica, consulte [Execute a reconciliação de software em Gestão de ativos de softwareclássico](https://servicenow-prod.fluidtopics.net/i3zbMbhqFaEHI5whaM61cw "A reconciliação é executada como um trabalho agendado (o padrão é semanal), mas você também pode executar a reconciliação manualmente para reconciliar produtos de software em seu ambiente sob demanda."). Para obter mais informações sobre como executar a reconciliação no Espaço de ativos de software, consulte [Execute a reconciliação de software no espaço](https://servicenow-prod.fluidtopics.net/_a9GDr8o8ynhlQskHBlDBQ "A reconciliação é executada como um trabalho agendado (o padrão é semanalmente), mas você também pode executar a reconciliação manualmente para reconciliar produtos de software no ambiente do Software Asset Workspace sob demanda.").