---
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 DocuSign

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

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

Integrando seu Gestão de ativos de softwareaplicação com DocuSigno serviço permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

DocuSignas compras feitas por meio de revendedores não se refletem em DocuSignsistema de faturamento padrão. Portanto, nenhum valor é retornado por meio das APIs para consumo de envelope que está disponível para ServiceNow.  
Nota:  
DocuSignremoveu o. Último login Campo da API de usuários. Portanto, as últimas atividades dos usuários não são rastreadas como parte desta integração.

Para obter mais informações sobre DocuSignserviço, consulte [O site do desenvolvedor DocuSign](https://developers.docusign.com/ios_sdk/developer.html).  
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-with-docusign__table_kcp_jts_nbc__entry__3}

| Processo | Função de usuário necessária no DocuSignaplicação | Escopos de autenticação |
|-|-|-|
| Download de assinaturas | administrador | Nenhum escopo |
| Recuperar assinatura | administrador | Nenhum escopo |
[Tabela 1. Permissões mínimas do usuário]

{#integrate-with-docusign__table_kcp_jts_nbc}

## Registre um DocuSignaplicação {#ariaid-title2}

Registre um DocuSignaplicação por meio de DocuSignportal do administrador.

### Antes de Iniciar

DocuSign Função necessária: administrador

### Procedimento

1. Faça login em DocuSignconta de demonstração (não produção).
2. Selecione sua imagem de perfil.
3. Selecione Minhas aplicações e chaves .
   * Se você já tiver uma chave de integração de API de uma integração anterior pronta para uso na produção, [vá para a etapa 33](https://servicenow-prod.fluidtopics.net/mzEmH5K_VO573I4x6lTjjw#register-docusign-app__docusign-prod-login).
   * Se você não tiver o segredo do cliente salvo, será necessário gerar um novo segredo.
   {#register-docusign-app__choices_zhf_2hm_m5b}
4. No painel esquerdo, selecione INTEGRAÇÕESApps e chaves.
5. Em Apps e chaves de integração , selecione ADICIONE APP E CHAVE DE INTEGRAÇÃO .
6. No formulário Adicionar chave de integração, forneça um nome no Nome da aplicação e selecione CRIAR APP .
7. Selecione ADICIONAR URI em URIs de redirecionamento campo no Configurações adicionais seção.
8. Adicionar <kbd class="ph userinput">https://oauth.pstmn.io/v1/browser-callback </kbd>.
9. Selecione ADICIONAR URI novamente e adicione <kbd class="ph userinput">https:// <var class="keyword varname">Instância da ServiceNow </var>.service-now.com/oauth_redirect.do </kbd>.
10. Selecione ADICIONE CHAVE SECRETA .  
    Salve a chave de integração (ID do cliente) e a chave secreta (segredo do cliente) em um local seguro para usá-los posteriormente no aplicativo Postman e a chave de integração (ID do cliente) no ServiceNowinstância. {#register-docusign-app__step9}
{#register-docusign-app__step9}
11. Selecione Salvar.
12. Baixe a versão mais recente de [App Postman](https://www.getpostman.com/)e ignore o login.
13. Selecionar Nova coleção e forneça um nome para a coleção.
14. Selecione Autorização .
15. No menu da lista Tipo, selecione OAuth 2,0 .
16. Forneça um nome e preencha os campos no Opções de configuração guia para criar um token:  
    {#register-docusign-app__table_h2h_zgf_dhb__entry__2}

    | Campo | Valor |
    |-|-|
    | URL do Retorno de Chamada | <kbd class="ph userinput">https://oauth.pstmn.io/v1/browser-callback</kbd> |
    | URL de autenticação | <kbd class="ph userinput">https://account-d.docusign.com/oauth/auth</kbd> |
    | URL do token de acesso | <kbd class="ph userinput">https://account-d.docusign.com/oauth/token</kbd> |
    | ID de cliente | A chave de integração do seu DocuSignconta de demonstração criada em [etapa 10](https://servicenow-prod.fluidtopics.net/mzEmH5K_VO573I4x6lTjjw#register-docusign-app__step9). |
    | Segredo do cliente | A chave secreta do seu DocuSignconta de demonstração [etapa 10](https://servicenow-prod.fluidtopics.net/mzEmH5K_VO573I4x6lTjjw#register-docusign-app__step9). |
    [ ]

    {#register-docusign-app__table_h2h_zgf_dhb}
17. Selecione Obter novo token de acesso .  
    Você será redirecionado para DocuSign.
18. Selecione Aceitar.
19. Depois que o token de acesso for coletado e a autenticação estiver concluída, copie o token de acesso para usá-lo mais tarde.
20. Selecione Nova solicitação Para criar uma solicitação GET para o ID da sua conta.
21. Insira a URL no campo OBTER como <kbd class="ph userinput">https://account-d.docusign.com/oauth/userinfo </kbd>.
22. Na guia Cabeçalhos, selecione Autorização em CHAVE e insira <kbd class="ph userinput">Portador <var class="keyword varname">Token de acesso que você copiou durante a autenticação&gt; </var> </kbd>em Valor .
23. Selecione Enviar e verifique se sua solicitação foi concluída.  
    O ID da conta é exibido no corpo da resposta.
24. Duplicar a solicitação GET.  
    Copie a chave de autorização e o valor em Cabeçalhos .
25. Atualize o URL no campo OBTER como <kbd class="ph userinput">https://demo.docusign.net/restapi/v2/accounts/&lt;account-id&gt;/usuários </kbd>.  
    Aqui, <var class="keyword varname">id da conta </var>É o ID que você salvou da solicitação anterior.
26. Selecione Enviar 20 vezes para fazer 20 chamadas de API.  
    Você deve invocar um mínimo de 20 chamadas de API para registrar sua aplicação por meio do DocuSignportal do administrador.
27. Navegue até Apps e chaves de integração em DocuSignportal do administrador.
28. Selecionar AçõesExibir painel de API ao lado da sua aplicação.
29. Aguarde alguns minutos por DocuSignPara registrar todas as 20 chamadas de API.
30. Navegar até INTEGRAÇÕESApps e chaves e selecione Enviar para revisão .  
    Após 5-20 minutos, a revisão da sua candidatura estará concluída. Você pode promover a aplicação para sua conta de produção.
31. Selecionar AçõesRevisão de Iniciar-Ir- em tempo real para promover a aplicação para a conta de produção.
32. Selecione uma conta de produção qualificada para gerenciar a chave de integração.
33. Faça login em DocuSignconta de conteúdo de produção. {#register-docusign-app__docusign-prod-login}
{#register-docusign-app__docusign-prod-login}
34. Selecione sua imagem de perfil.
35. Selecione Vá para Administrador .
36. No painel esquerdo, selecione INTEGRAÇÕESApps e chaves.  
    Localize o ID da conta da API a ser usado para o perfil de integração no ServiceNowinstância.
37. Ao lado da sua aplicação, selecione AçõesEditar.
38. Selecione ADICIONAR URI e adicionar <kbd class="ph userinput">https:// <var class="keyword varname">Instância da ServiceNow </var>.service-now.com/oauth_redirect.do </kbd>.
39. Selecione ADICIONE CHAVE SECRETA .  
    Salve a chave secreta (segredo do cliente) da sua conta de produção em um local seguro para usá-la no ServiceNowinstância. {#register-docusign-app__step39}
{#register-docusign-app__step39}
40. Selecione Salvar.
{#register-docusign-app__steps_tyr_3rg_ynb}

## Criação do perfil de Integração DocuSign {#ariaid-title3}

Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento para o. DocuSignserviço.

### Antes de Iniciar

Para criar um DocuSignperfil 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

### Por Que e Quando Desempenhar Esta Tarefa

Se você estiver usando Espaço para ativos de software, a opção para criar o. DocuSignperfil 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 Direta. 2. Selecione Novo. 3. Selecione Perfil de integração DocuSign . {#create-integration-profile-docusign__ol_ijd_bjk_qtb} |
   | Espaço de ativos de software | 1. Navegar até Operações de licençaAssinaturas de UsuárioPerfis de integração diretos. 2. Selecione Novo. 3. Selecione DocuSign na lista suspensa. 4. Selecione Continuar. {#create-integration-profile-docusign__ol_wjd_bjk_qtb} |
   |-|-|

   {#create-integration-profile-docusign__choicetable_o3p_z3k_qtb}
2. No formulário, preencha os campos.  
   {#create-integration-profile-docusign__table_gnm_whv_5fb__entry__2}{#create-integration-profile-docusign__display-name-def}{#create-integration-profile-docusign__client-id-def}{#create-integration-profile-docusign__redirect-url-def}{#create-integration-profile-docusign__activity-date}{#create-integration-profile-docusign__client-secret-def}{#create-integration-profile-docusign__profile-type-def}

   | Campo | Valor |
   |-|-|
   | Nome de exibição | Nome do perfil de integração. Por exemplo, <kbd class="ph userinput">Integração com DocuSign </kbd> |
   | ID de Cliente | ID do cliente para a aplicação OAuth criada em [etapa 10](https://servicenow-prod.fluidtopics.net/mzEmH5K_VO573I4x6lTjjw#register-docusign-app__step9)em SaaSconta de administrador. |
   | URL de redirecionamento | URL do provedor OAuth para o qual você foi redirecionado após a autenticação. Este valor é preenchido automaticamente. |
   | ID da conta técnica | ID da conta da API do seu DocuSignconta de produção. |
   | URL da instância | URL da página de login usada para acessar o. DocuSignconta de produção. Este campo é definido automaticamente como https://account.docusign.com . |
   | Segredo do cliente | Senha associada ao ID do cliente criado em [etapa 39](https://servicenow-prod.fluidtopics.net/mzEmH5K_VO573I4x6lTjjw#register-docusign-app__step39). |
   | Tipo de perfil | Tipo de perfil de integração. Este valor é definido automaticamente como Assinatura DocuSign . |
   [Tabela 2. Formulário de perfil de integração]

   {#create-integration-profile-docusign__integration-form-title}
3. Revise as funções de usuário necessárias ou as permissões de API especificadas no Configuração do fornecedor campo para cada processo 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/mzEmH5K_VO573I4x6lTjjw#integrate-with-docusign "Integrando seu Gestão de ativos de softwareaplicação com DocuSigno serviço permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.")tabela.
   * . Baixar assinaturas a caixa de seleção está marcada por padrão e você não pode desmarcá-la.

   * . 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-docusign__ul_nmd_wsd_xcc}
4. Selecione Enviar.  
   Seu ServiceNowa instância cria um perfil de integração de rascunho.
5. No perfil de integração, selecione Obter token OAuth E siga as etapas para obter um token 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/mzEmH5K_VO573I4x6lTjjw#integrate-with-docusign "Integrando seu Gestão de ativos de softwareaplicação com DocuSigno serviço permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.")tabela.
6. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.  
   A validação da conexão verifica as APIs de download de assinaturas, mas não as APIs de recuperação de assinaturas.

### Resultado

Você pode exibir eventos realizados por usuários individuais até um ano 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."). Gestão de ativos de softwareextrai os eventos do momento em que você começa a baixar assinaturas de usuário, independentemente da data de criação do perfil.

### O que Fazer Depois

Após a integração se conectar, seu ServiceNowa instância cria automaticamente modelos de software, regras de recuperação e assinaturas de software que são atualizadas diariamente.

Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e configurações para cada perfil de integração. Para obter mais informações, consulte [Crie um alias secundário para configurar vários perfis de integração](https://servicenow-prod.fluidtopics.net/loeiE6zEEgiP9DeR7B3Ebg "Crie um alias secundário para configurar vários perfis de integração com conexões exclusivas e gerenciar configurações diferentes para cada perfil de integração.").

Revise todas as regras de recuperação geradas automaticamente 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 softwareIU principal, 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.").
{#create-integration-profile-docusign__ul_cbz_vhr_sqb}  
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.").
{#create-integration-profile-docusign__ul_qgf_zhr_sqb}