Integração com Cisco Webex

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 7 min. de leitura

    • Integrar sua aplicação Gestão de ativos de software com aplicações Cisco Webex permite que você rastreie suas assinaturas de software e recupere licenças não utilizadas.

    As aplicações Cisco Webex compatíveis são:
    • Webex Reuniões
    • Webex Equipes
    • Webex Treinamento
    • Webex Eventos
    • Webex Sessão de suporte
    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.
    Tabela 1. Permissões mínimas do usuário
    Processo Função do usuário necessária na aplicação Cisco Webex Escopos de autenticação
    Baixar assinaturas Administrador somente leitura
    • spark-admin:licenses_read
    • spark-admin: People_read
    Extrair atividade do usuário
    • Responsável pela conformidade
    • Administrador completo
    • spark-conformidade: eventos_leitura
    • meeting:admin_schedule_read
    Recuperar assinatura Administrador completo
    • spark-admin: People_read
    • spark-admin: pessoas_escrever

    Criar uma aplicação OAuth de Webex reuniões

    Crie uma aplicação de integração OAuth no Cisco DevNet.

    Antes de Iniciar

    Webex Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Faça login no portal do desenvolvedor do Webex usando suas credenciais Webex.
    2. Selecione o ícone do seu perfil e selecione Minhas aplicações Webex.
    3. Navegar até Criar um novo app > Selecionar integração > Criar uma integração.
    4. No formulário, preencha os campos:
      Tabela 2. Novo formulário de integração
      Campo Valor
      Esta integração usará um Mobile SDK? Não
      Nome da integração Nome da sua integração como ele aparece em Webex. Por exemplo, integração ServiceNow.
      E-mail do Contato Endereço de e-mail do administrador.
      Ícone Ícone a ser exibido na página Meus apps. Carregue seu próprio ícone de aplicação ou selecione um na lista de ícones padrão.
      Descrição Descrição da sua integração. Por exemplo, a funcionalidade da integração e seus benefícios.
      Redirecionar URI O URI para o qual será redirecionado ao concluir um fluxo de concessão do OAuth.https://<instance> .service-now.com/oauth_redirect.do , em que instância é o nome da sua instância ServiceNow.
      Escopos Para acessar as APIs de integração, você deve selecionar o escopo meeting:admin_schedule_read.
    5. Selecione Adicionar Integração.
    6. Copie e salve o ID do clienteOAuth e o segredo do cliente OAuth que aparecem para uso posterior.

    Criar uma aplicação OAuth de Webex Teams

    Crie uma aplicação de integração OAuth em Cisco Webex para desenvolvedores.

    Antes de Iniciar

    Webex Função necessária: consulte a tabela Permissões mínimas do usuário.

    Procedimento

    1. Navegue e faça login no Cisco Webex para desenvolvedores.
    2. No ícone do perfil, selecione Minhas aplicações Webex.
    3. Navegar até Criar um novo app > Selecionar integração > Criar uma integração.
    4. No formulário, preencha os campos:
      Tabela 3. Novo formulário de integração
      Campo Valor
      Esta integração usará um Mobile SDK? Não
      Nome da integração Nome da sua integração como ele aparece em Webex. Por exemplo, integração ServiceNow.
      E-mail do Contato Endereço de e-mail do administrador.
      Ícone Ícone a ser exibido na página Meus apps. Carregue seu próprio ícone de aplicação ou selecione um na lista de ícones padrão.
      Descrição Descrição da sua integração. Por exemplo, a funcionalidade da integração e seus benefícios.
      Redirecionar URI O URI para o qual será redirecionado ao concluir um fluxo de concessão do OAuth.https://<instance> .service-now.com/oauth_redirect.do , em que instância é o nome da sua instância ServiceNow.
      Escopos Para acessar as APIs de integração, você deve selecionar estes escopos:
      • spark-admin:licenses_read
      • spark-admin:organizations_read
      • spark-admin: People_read
      • spark-admin: pessoas_escrever
      • spark-admin:roles_read
      • spark-conformidade: eventos_leitura
      • meeting:admin_schedule_read
    5. Selecione Adicionar Integração.
    6. Copie e salve o ID do clienteOAuth e o segredo do cliente OAuth que aparecem para uso posterior.

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

    Crie um perfil de integração para rastrear assinaturas de software e otimizar o licenciamento das aplicações Cisco Webex.

    Antes de Iniciar

    Para criar um perfil de integração Webex, solicite os aplicativos spoke Cisco Webex Meetings e Webex Teams na ServiceNow Store.

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

    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 [ Webex em IU principal estará inativa.

    Procedimento

    1. Navegue até o perfil de integração.
      InterfaceAção
      IU principal
      1. Navegar até Todos > Ativo de Software > Licença de SaaS > Perfis de Integração Direta.
      2. Selecione Novo.
      3. Selecione o perfil de integração do Webex.
      Espaço de ativo do software
      1. Navegar até Operações de licença > Assinaturas de Usuário > Perfis de integração direta.
      2. Selecione Novo.
      3. Selecione Webex na lista suspensa.
      4. Selecione Continuar.
    2. No formulário, preencha os campos.
      Tabela 4. Formulário de perfil de integração
      Campo Valor
      Nome de visualização Nome do perfil.

      Por exemplo, integração Webex.
      Status Status do perfil de integração.
      • Se você não publicou o perfil de integração, este campo será definido automaticamente como Rascunho.
      • Se você já publicou o perfil de integração, este campo será definido automaticamente como Publicado.
      Tipo de perfil Tipo de perfil de integração.

      Este campo é definido automaticamente como Webex Assinatura.
    3. Na seção de formulário Calcular subfluxo de atividade, escolha um valor para o campo Analisar atividade do usuário de.
      Você também pode selecionar a data e a hora em que deseja analisar a atividade do usuário no campo Analisar atividade do usuário de. Por padrão, você pode analisar a atividade do usuário até 60 dias antes da data atual e exibir eventos realizados por usuários individuais a partir do momento em que cria este perfil.
      Nota:
      Gestão de ativos de software extrai os eventos a partir do momento em que você começa a analisar a atividade do usuário, independentemente da data de criação do perfil.
      Você pode modificar este valor no campo Limite de última atividade das regras de recuperação de software. Para obter mais informações, consulte Revisar uma regra de recuperação de software.
    4. Selecione Salvar.
      Um perfil de integração de rascunho é criado. O perfil de integração usa os subfluxos Webex Baixar assinatura, Webex Calcular atividade e Webex Recuperar assinatura para obter dados do usuário das aplicações Webex.
    5. No Subfluxo de assinaturade download, selecione o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e selecione Abrir registro na visualização do registro.
    6. Se você vir um texto no registro como , este registro está na aplicação Cisco Webex Teams Spoke, mas 'xxx' é a aplicação atual. Para editar o registro, clique aqui, selecione o link.
      1. Defina o registro do modelo de configuração como SAM SaaS Webex Teams.
      2. Salve o registro.
    7. Selecione o link relacionado Criar nova conexão e credencial.
    8. No formulário, preencha a ID do clienteOAuth e o segredo do cliente OAuth que você salvou ao criar a aplicação Webex Teams OAuth.
      Deixe todos os outros campos como estão.
    9. 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.
    10. Quando solicitado, faça login usando seu endereço de e-mail Webex e senha.
    11. Depois que a conexão for criada com sucesso, navegue até o perfil de integração Webex.
    12. Em Calcular subfluxo de atividade, selecione o ícone de visualização (ícone de visualização) ao lado do campo Conexão e credencial e selecione Abrir registro na visualização do registro.
    13. Selecione o link relacionado Criar nova conexão e credencial.
    14. No formulário, preencha os campos.
      Tabela 5. Formulário Criar Conexão e Credencial
      URL de Conexão

      Substituir<subdomain> com o domínio do site de reunião Webex configurado para a organização.

      Faça login no portal do administrador do Webex e navegue até SERVIÇOS > Reunião > Sites. Na coluna Nome do site,<subdomain> é a parte de .webex.com no nome do site.
      Nome de usuário do administrador do Webex Nome de usuário ou endereço de e-mail para fazer login em Webex.
    15. Preencha os valores de ID do clienteOAuth e segredo do cliente OAuth que você salvou ao criar a aplicação Webex Meetings OAuth.
    16. Selecione Criar e obter token OAuth e siga as etapas para obter um token OAuth.
      Nota:
      Para a função necessária para executar esta etapa, consulte a tabela Permissões mínimas do usuário.
    17. Retorne ao perfil de integração e selecione Publicar.

    O que Fazer Depois

    Depois que a integração se conecta, sua instância ServiceNow cria automaticamente modelos de software, regras de recuperação e assinaturas de usuário que são atualizadas diariamente.

    Revise todas as regras de recuperação geradas automaticamente para recuperar assinaturas de usuário. Para obter mais informações, consulte Revisar 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 de propriedade.
    A reconciliação também é executada em suas assinaturas como um trabalho agendado ou sob demanda. Você pode exibir os resultados da reconciliação no Workbench de licenças (Gestão de ativos de software aplicação clássica) ou na 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.