Integrar Adobe Cloud usando OAuth Server-to-Server credencials

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 6 min. de leitura

    • Integre sua instância ServiceNow® com serviços Adobe Cloud usando credenciais de servidor para servidor OAuth.

    Criar um projeto e adicionar APIs usando OAuth

    Crie um projeto no Adobe Developer Console para acessar Adobe APIs e adicione APIs ao seu projeto usando o OAuth.

    Antes de Iniciar

    Função necessária: administrador do Adobe Cloud

    Procedimento

    1. Crie um projeto no Adobe Console do desenvolvedor para acessar as Adobe APIs selecionando Criar novo projeto.
      Para obter mais informações, consulte Visão geral de projetos.
    2. Adicione uma API ao seu projeto selecionando Adicionar API.
      Para obter mais informações, consulte Adicionar API ao projeto usando OAuth.
    3. Selecione a API de gestão de usuários para o serviço Adobe ao qual você deseja integrar.
      Este serviço permite que você acesse a Adobe API de gestão de usuários. Depois de adicionar com sucesso a API ao seu projeto, você será redirecionado para a página de visão geral da API.
    4. Selecione Avançar.
    5. No formulário Configurar API, expanda Credenciais.
    6. Selecione a autenticação OAuth de servidor para servidor.
    7. Forneça um nome no campo Nome da credencial para encontrar facilmente a credencial de API correta no Console do administrador > Usuários > Credenciais de API.
      Você também pode modificar o nome posteriormente em seu projeto na página de visão geral da credencial OAuth de servidor para servidor.
    8. Selecione Salvar API configurada.
      Os seguintes valores são exibidos na página de visão geral de credencial:
      • ID DO CLIENTE
      • CLIENT SECRET
      • ESCOPOS
      • NOME DA CREDENCIAL
      • ID DA CONTA TÉCNICA
      • E-MAIL DA CONTA TÉCNICA
      • ID DA ORGANIZAÇÃO
      Nota:

      Copie o ID do CLIENTE e o ID da ORGANIZAÇÃO e recupere também o segredo do CLIENTE para usá-los mais tarde.

    9. Obtenha a URL de conexão (instância) URL do Adobe Console do desenvolvedor para criar e obter um token OAuth para Adobe Cloud.
      1. Na seção Gerar token de acesso, selecione Exibir comando cURL.
      2. Copie a URL de conexão.
        Nota:

        Copie somente o URL necessário de todo o comando.

        Por exemplo, aqui o URL de conexão é a parte realçada.

        URL de conexão no Adobe Developer Console.

    Criar um perfil de integração Adobe Cloud usando OAuth

    Crie um perfil de integração Adobe Cloud em sua instância ServiceNow usando credenciais OAuth para rastrear suas assinaturas de software e determinar a conformidade da licença.

    Antes de Iniciar

    Função necessária: sam_admin, sam_integrator

    Ative os seguintes plug-ins:
    • Software Asset Management Professional para Adobe (com.sn_samp_adobe)
    • Gestão de ativos de software - Gestão de licenças de SaaS (sn_sam_saas_int) da ServiceNow Store

    Por Que e Quando Desempenhar Esta Tarefa

    Se você estiver usando Espaço para ativos de software, a opção para criar o perfil de integração Adobe Cloud em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Tudo > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione Perfil de integração do Adobe Cloud.
      Espaço para ativos de software
      1. Navegar até Operações de licença > Assinatura de usuário > Perfis de integração diretos.
      2. Selecione Novo.
      3. Selecione Adobe Cloud na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 1. Formulário Perfil de integração
      Campo Descrição
      Nome de exibição Nome do perfil de integração Adobe Cloud.
      Tipo de autenticação Tipo de autenticação para acessar Adobe Cloud APIs.
      • OAuth 2.0
      • JWT
      Nota:
      • Para os perfis de integração Adobe Cloud existentes antes do upgrade para a versão Gestão de ativos de software - Gestão de licenças de SaaS 13.1.0 ou posterior, este campo é definido automaticamente como JWT. Para obter mais informações, consulte Integrar Adobe Cloud usando Conta de Serviço (JWT) credencials.
      • Para todos os novos perfis de integração Adobe Cloud, este campo é definido automaticamente como OAuth 2.0.
      Tipo de perfil Tipo de perfil de integração. Este campo é definido automaticamente como Adobe assinatura.
    3. Na seção Configuração de processo, exiba as funções de usuário necessárias ou as permissões de API para minimizar os riscos de segurança e otimizar SaaS licenças.
      Nota:

      A caixa de seleção Baixar assinaturas está marcada por padrão e você não pode desmarcá-la.

      Para obter mais informações sobre as funções e os escopos necessários, consulte Tabela de permissões mínimas do usuário.
    4. Selecione Enviar.
      O campo Conexão e credencial aparece no formulário e é definido automaticamente como sn_sam_saas_int.Adobe_OAuth.
    5. Selecione o ícone de visualização ( ícone de visualização) ao lado do campo Conexão e credencial para abrir o registro Aliases de conexão e credencial.
    6. Selecione o link relacionado Criar nova conexão e credencial.
    7. No formulário, preencha os campos.
      Tabela 2. Criar um formulário de conexão e credencial
      Campo Descrição
      Nome da conexão Nome da conexão Adobe Cloud.
      URL de conexão (URL da instância) URL da conexão. Este campo é definido automaticamente como https://<Instance Name> .adobelogin.com . Para obter mais informações sobre as etapas para obter o URL, consulte Etapa 9 em Criar um projeto e adicionar APIs usando OAuth.
      ID do cliente do OAuth ID do cliente que você gerou ao criar uma credencial do Adobe Cloud OAuth.
      Segredo do cliente do OAuth Segredo do cliente que você recuperou ao criar uma credencial do Adobe Cloud OAuth.
      URL de redirecionamento do OAuth https://<instance_name> /oauth_redirect.do , em que o nome da instância é o nome da sua instância ServiceNow.
      ID da organização Adobe Cloud ID da organização que você encontra ao criar uma credencial do Adobe Cloud OAuth.
    8. Selecione Criar e obter um Token do OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    9. No formulário de perfil de integração, selecione Validar conexão para verificar os detalhes de conexão e credencial desta integração.

    Resultado

    Adobe dados de assinatura são extraídos para Gestão de ativos de software quando o trabalho agendado SAM - Import Adobe User Subscriptions é executado. Quando os dados de assinatura são extraídos, o trabalho agendado SAM - Optimize Adobe Subscriptions é executado mensalmente para otimizar as assinaturas Adobe do Creative Cloud.

    A conclusão deste trabalho resulta no seguinte:
    • Um candidato de otimização que consolida três (configuráveis) ou mais aplicações únicas ou assinaturas de produtos individuais e recomenda Adobe todas as aplicações do Creative Cloud quando não está instalado.
    • Um candidato de recuperação que recupera assinaturas de aplicações únicas ou de produtos individuais com licenças duplas quando Adobe todas as aplicações do Creative Cloud estão instaladas.

      Digamos que um usuário tenha assinado Adobe Todos os aplicativos do Creative Cloud e também consuma licenças de um único aplicativo ou produtos individuais, como Adobe Acrobat e Adobe Photoshop. Neste cenário de licença dupla, a aplicação Gestão de ativos de software recomenda recuperar as licenças para aplicações únicas ou assinaturas de produtos individuais.

    • Um candidato de recuperação que recupera três (configuráveis) ou mais aplicações únicas ou assinaturas de produtos individuais que são usadas ativamente e um candidato de otimização que recomenda atribuir Adobe Creative Cloud a todas as aplicações.

      Digamos que um usuário tenha assinado o Adobe Acrobat, o Adobe Illustrator e o Adobe Photoshop e use todos esses produtos ativamente. Neste cenário, a aplicação Gestão de ativos de software recomenda recuperar as licenças dessas assinaturas de produto individuais e o uso de Adobe Creative Cloud All Apps.

    • Um candidato de recuperação que recupera Adobe todas as aplicações do Creative Cloud quando menos de três produtos individuais (configuráveis) são usados ativamente e um candidato de otimização que recomenda atribuir assinaturas de produto individual ou de app único que são usadas ativamente.

      Digamos que um usuário tenha assinado Adobe Todos os aplicativos do Creative Cloud, mas esteja usando menos de três produtos individuais do Creative Cloud ativamente. Neste cenário, a aplicação Gestão de ativos de software recupera a licença Adobe de todas as aplicações do Creative Cloud e recomenda atribuir essas assinaturas de produto individuais que são usadas ativamente.

    O que Fazer Depois

    Se você quiser configurar vários perfis de integração com conexões exclusivas, crie aliases secundários para gerenciar diferentes configurações e definiçõ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.

    Exibir os dados de assinatura navegando até Tudo > Licença de SaaS > Todas as Assinaturas do Usuário. Você pode verificar o status do trabalho SAM - Import Adobe User Subscriptions navegando até Tudo > Ativo de Software > Administração > Resultados do Trabalho.

    Você também pode exibir informações sobre suas Adobe assinaturas, conformidade e custos no Painel do Office 365 e Adobe Cloud no clássico Gestão de ativos de software.

    Depois de criar um perfil de integração, você pode exibir informações sobre modelos de software, identificadores de assinatura não reconhecidos, trabalhos agendados, resultados de trabalhos agendados e assinaturas de software no Espaço para ativos de software. Navegar até Operações de licença > Assinatura de usuário > Perfis de integração diretos.