Integração com DocuSign

Integrando seu Software Asset Management aplicação com DocuSign o serviço permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

DocuSign as compras feitas por meio de revendedores não se refletem em DocuSign sistema de faturamento padrão. Nenhum valor é retornado por meio das APIs para consumo de envelope que está disponível para ServiceNow.

Importante:

DocuSign removeu Último Login Da API Usuários, para que as últimas atividades do usuário não sejam mais rastreadas como parte desta integração. . Software Asset Management a aplicação agora cria candidatos de recuperação com base na data atribuída à assinatura.

Para obter mais informações sobre DocuSign serviço, consulte O site do DocuSign Developer .

Importante:

Minimize os riscos à segurança e proteja as informações concedendo acesso somente ao usuário ou às permissões de API necessárias.

Tabela 1. Permissões mínimas do usuário

Processo	Função de usuário necessária no DocuSign aplicação	Escopos de autenticação
Download de assinaturas	administrador	Não há escopos
Recuperar assinatura	administrador	Não há escopos

Registre um DocuSign aplicação

Registre um DocuSign por meio do DocuSign portal do administrador.

Antes de Iniciar

DocuSign Função necessária: administrador

Procedimento

1. Faça login no seu DocuSign conta 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, pule para a etapa 33 .
   • Se você não tiver o segredo do cliente salvo, será necessário gerar um novo.
4. No painel esquerdo, selecione INTEGRAÇÕES > Apps e chaves.
5. Em Chaves de integração e apps , selecione ADICIONAR APP E CHAVE DE INTEGRAÇÃO .
6. No formulário Adicionar chave de integração, forneça um nome em Nome da aplicação e selecione CRIAR APP .
7. Selecione ADICIONAR URI em URIs de redirecionamento . Configurações adicionais seção.
8. Adicionar https://oauth.pstmn.io/v1/browser-callback .
9. Selecione ADICIONAR URI novamente e adicione https:// Instância da ServiceNow .service-now.com/oauth_redirect.do .
10. Selecione ADICIONAR CHAVE SECRETA .
    Salve a Chave de integração (ID do cliente) e a Chave secreta (segredo do cliente) em um local seguro para usá-las posteriormente no aplicativo Postman e a Chave de integração (ID do cliente) no ServiceNow instância.
11. Selecione Save (Salvar).
12. Baixe a versão mais recente de Aplicativo Postman e ignore o login.
13. Selecionar Nova coleção e forneça um nome para a coleção.
14. Selecione Autorização guia.
15. No menu de lista Tipo, selecione OAuth 2,0 .
16. Forneça um nome e preencha os campos no Opções de configuração para criar um token:

    Campo	Valor
    URL do Retorno de Chamada	https://oauth.pstmn.io/v1/browser-callback
    URL de autenticação	https://account-d.docusign.com/oauth/auth
    URL do token de acesso	https://account-d.docusign.com/oauth/token
    ID de cliente	A chave de integração do seu DocuSign conta de demonstração criada em etapa 10 .
    Segredo do cliente	A chave secreta do seu DocuSign conta de demonstração etapa 10 .

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 for concluída, copie o token de acesso para usá-lo posteriormente.
20. Selecione Nova solicitação Para criar uma solicitação GET para o ID da sua conta.
21. Insira o URL no campo OBTER como https://account-d.docusign.com/oauth/userinfo .
22. Na guia Cabeçalhos, selecione Autorização em CHAVE e insira Portador Token de acesso que você copiou durante a autenticação> em Valor .
23. Selecione Enviar e verifique se sua solicitação está 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 https://demo.docusign.net/restapi/v2/accounts/<account-id>/usuários .
    Aqui, id da conta É 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 DocuSign portal do administrador.
27. Navegue até Chaves de integração e apps em DocuSign portal do administrador.
28. Selecionar Ações > Exibir Painel de API ao lado da sua aplicação.
29. Aguarde alguns minutos para DocuSign Para registrar todas as 20 chamadas de API.
30. Navegar até INTEGRAÇÕES > Apps 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ções > Revisão inicial-Go- Live 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 no seu DocuSign conta de conteúdo de produção.
34. Selecione sua imagem de perfil.
35. Selecione Vá para Administrador .
36. No painel esquerdo, selecione INTEGRAÇÕES > Apps e chaves.
    Localize o ID da conta da API a ser usado para o perfil de integração em seu ServiceNow instância.
37. Ao lado da sua aplicação, selecione Ações > Editar.
38. Selecione ADICIONAR URI e adicionar https:// Instância da ServiceNow .service-now.com/oauth_redirect.do .
39. Selecione ADICIONAR CHAVE SECRETA .
    Salve a chave secreta (segredo do cliente) da sua conta de produção em um local seguro para usá-la em seu ServiceNow instância.
40. Selecione Save (Salvar).

Criação do perfil de Integração DocuSign

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

Antes de Iniciar

Para criar um DocuSign perfil de integração, solicite o. Software Asset Management- Gestão de licenças de SaaS plug-in (sn_sam_saas_int) do ServiceNow Store .

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. DocuSign perfil de integração em IU principal está inativo.

Procedimento

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

   Interface	Ação
   IU principal	Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta. Selecione Novo. Selecione Perfil de integração do DocuSign .
   Espaço de ativo do software	Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração diretos. Selecione Novo. Selecione DocuSign na lista suspensa. Selecione Continuar.

2. No formulário, preencha os campos.

   Tabela 2. Formulário Perfil de integração

   Campo	Valor
   Nome de exibição	Nome do perfil de integração. Por exemplo, Integração do DocuSign
   ID de Cliente	ID do cliente para a aplicação OAuth criada em etapa 10 em SaaS conta 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 DocuSign conta de produção.
   URL da Instância	URL da página de login usada para acessar seu DocuSign conta 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 .
   Tipo de perfil	Tipo de perfil de integração. Este valor é definido automaticamente como Assinatura do DocuSign .

3. Revise as funções de usuário necessárias ou permissões de API especificadas em Configuração do fornecedor campo para cada processo para minimizar os riscos de segurança e otimizar SaaS licenças.
   Nota:

   Para obter mais informações sobre as funções e escopos necessários, consulte Permissões mínimas do usuário 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 a remoção serão criados, mas o subfluxo Recuperar assinatura não será acionado ou o processo de recuperação não será iniciado.

4. Selecione Enviar.
   . ServiceNow a 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 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.

   Validar a 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. Software Asset Management extrai os eventos da hora em que você começa a baixar assinaturas do usuário, independentemente da data de criação do perfil.

O que Fazer Depois

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

Depois de criar um perfil de integração, exiba informações sobre o perfil no Espaço para ativos de software navegando até Operações de licença > Assinatura de usuário > Perfis de integração diretos. Você pode selecionar um perfil de integração para exibir as listas relacionadas a seguir. Se todas as listas relacionadas a seguir não estiverem visíveis para um perfil de integração na exibição padrão, você poderá selecionar a exibição de integração personalizada na guia Detalhes:

• Modelos de software
• Identificadores de assinatura não reconhecidos
• Trabalhos agendados
• Resultados de trabalhos programados
• Assinaturas de Software
• Regra de exclusão de identificador de assinatura
• Regra de exclusão do usuário de assinatura

Depois de criar um perfil de integração, você pode definir regras de exclusão de assinatura para manter determinadas assinaturas dos cálculos de custo de licença. Para obter mais informações, consulte Exclusões de assinatura para SaaS E aplicações SSO.

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.

Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas do usuário. Para obter mais informações, consulte Revise uma regra de recuperação de software.

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 Software Asset Management IU principal, consulte Criar direitos em Software Asset Management clássico.
• Para obter mais informações sobre como criar direitos de software no Software Asset Workspace, consulte Criar direitos no espaço.
• Para obter mais informações sobre como criar direitos de software usando Software Asset Management Playbook, consulte Crie direitos usando o passo a passo guiado.

A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados de reconciliação no Workbench de licença ( Software Asset Management aplicação clássica) ou Exibição de uso de licença (Software Asset Workspace). Use esses 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 Software Asset Management aplicação clássica, consulte Execute reconciliação de software em Software Asset Management clássico.
• Para obter mais informações sobre como executar reconciliação no Software Asset Workspace, consulte Execute a reconciliação de software no espaço.