Criar um mapeamento do atributo SCIM

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Crie um mapeamento de atributo SCIM e use-o como uma fonte única de recurso para os campos da tabela da ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    A seguir estão os tipos de mapeamento de atributo e suas descrições.
    Tabela 1. Tipos de mapeamentos de atributo
    Tipo de mapeamento de atributo Descrição
    Direto O atributo SCIM é preenchido com a ajuda dos campos Nome da tabela do banco de dados e Nome do campo do banco de dados.
    Constante O atributo SCIM é preenchido com a ajuda de um valor padrão especificado.
    Script/personalização O atributo SCIM é preenchido com a ajuda do valor de retorno de um script. Este atributo requer a habilitação da opção de executar script.
    Nota:
    • O atributo de senha não é compatível
    • Um exemplo de mapeamento de atributo para os recursos de Usuário e Grupo faz parte do sistema de base. Você pode usar e configurar os mapeamentos com base em seus requisitos ou pode criar um novo registro.

    Procedimento

    1. Navegar até Tudo > Cliente de SCIM > Mapeamento de recursos do provedor de SCIM.
    2. Selecione o Mapeamento de recursos de SCIM que é criado para a configuração.
    3. Na lista relacionada Mapeamentos de atributo SCIM, clique em Novo.
      Mapeamento de recursos do Provedor de SCIM
    4. No formulário, preencha os campos.
      Tabela 2. Formulário de Mapeamentos de atributos SCIM
      Campos Descrição
      Mapeamento dos recursos do provedor

      Mapeamento de atributos para uma combinação de provedor-recurso.

      Se este campo não for preenchido automaticamente, use a opção de pesquisa. Selecione o registro Mapeamento de recursos do provedor.

      Nome de Esquema

      Nome do esquema do atributo SCIM para o qual o mapeamento deve ser definido.

      Por exemplo, urn:ietf:params:scim:schemas:core:2.0:User.

      Atributo

      Atributo para o qual o mapeamento deve ser definido. Por exemplo, userName.

      Subatributo

      Subatributo (se houver) para o qual o mapeamento deve ser definido.

      Por exemplo, se houver um atributo de tipo complexo como name.familyName, o atributo será o nome e o subatributo será sobrenome.

      Tipo de Campo

      O tipo de dados do atributo SCIM. Este campo é preenchido automaticamente a partir dos esquemas definidos pelo Provedor de SCIM.

      Por exemplo, booliano.

      Valores múltiplos

      Valores múltiplos que são atribuídos ao atributo. Um atributo pode ter valores múltiplos, como e-mail comercial, e-mail residencial ou outro e-mail.

      Por exemplo, emails.

      Este campo é preenchido usando os esquemas definidos pelo provedor de SCIM.

      Condição do filtro

      Alguns atributos de valores múltiplos podem ter informações adicionais que podem ser especificadas usando uma Condição do filtro. As opções de condição do filtro são preenchidas usando os esquemas definidos pelo Provedor de SCIM.

      Por exemplo, o atributo phoneNumbers tem vários tipos, como trabalho, para celular, casa e assim por diante

      Exclusivo

      Opção para identificar exclusivamente um recurso entre os sistemas do Cliente de SCIM e do Provedor de SCIM. Atributos de valores múltiplos não podem ser marcados como exclusivos.

      Por exemplo, para um Recurso do usuário, o atributo username pode se tornar exclusivo.

      Nome da tabela do banco de dados Use este campo para mapear o nome da tabela de atributos para o nome da tabela da ServiceNow. Se escolher o mapeamento de atributo direto, você deverá definir este campo.

      Por exemplo, o usernameAtributo SCIM pode ser mapeado para o campo Usuário no campo Nome da tabela do banco de dados.

      Nome do campo do banco de dados

      O campo Nome do campo de banco de dados mapeia o atributo SCIM para o nome do campo da ServiceNow a ser mapeado com o atributo SCIM. Se escolher o mapeamento de atributo direto, você deverá definir este campo.

      Por exemplo, o usernameAtributo SCIM pode ser mapeado para o campo ID do Usuário no campo Nome do campo do banco de dados.

      Valor Padrão

      Detalhes sobre o valor padrão que é passado para o Provedor de SCIM.

      Pode ser usado se o mapeamento de atributo direto do campo retornar nulo ou se o padrão puder ser usado para retornar um valor codificado.

      No caso de um valor codificado, o nome da tabela de banco de dados e o nome do campo devem ser Nenhum.

      Por exemplo, o valor do subatributo primário do e-mail comercial pode ser codificado como verdadeiro.

      Executar script

      Opção para buscar o valor do atributo via script.

      Esta opção é necessária para os atributos de valores múltiplos que não contêm uma condição do filtro. Para um tipo complexo de atributo, um script pode fornecer o valor em um nível de atributo ou subatributo.

      Por exemplo, o atributo Membros do recurso de grupo não tem condição do filtro. Portanto, a opção de script deve ser definida no nível de atributo primário do atributo Membros.

      Script

      Script usado para buscar o valor do atributo.

      O tipo de retorno do script deve ser uma cadeia de caracteres ou um JSON convertido como cadeia de caracteres.

      A saída do script deve estar no formato apropriado conforme esperado pelo provedor para esse atributo.

    5. Clique em Enviar.