Limpar valores de atributos (Pré-visualização)

O provisionamento Microsoft Entra pode limpar um valor de atributo alvo existente quando o atributo de origem correspondente está nulo ou vazio. Esta capacidade, também conhecida como "provisão de valor nulo", é útil quando um valor é removido do seu sistema de registo e o valor correspondente também deve ser removido do sistema de destino.

A configuração para limpar valores de atributos é consistente entre as integrações de provisão suportadas. No entanto, o editor de esquema de origem e a forma como um sistema de origem representa um valor nulo podem variar consoante a integração.

Âmbito de pré-visualização e limitações

• Limpar valores de atributos está disponível em versão preliminar para provisionamento de entrada com base em API para:
  • Microsoft Entra ID.
  • Active Directory local.
• Limpar valores de atributos só é suportado para atributos de valor único.
• Esta funcionalidade pode ser ativada para o provisionamento personalizado de atributos de segurança.
• Limpar valores de atributos não é atualmente suportado para:
  • Cenários de provisionamento de aplicações de saída.
  • Provisionamento de entrada do Workday ou SAP SuccessFactors.
• A limpeza de atributos multivalorados não é suportada.

Como os valores dos atributos são eliminados

A limpeza dos valores dos atributos está desativada por predefinição e tem de ser ativada explicitamente. A eliminação dos valores dos atributos utiliza um mecanismo de proteção de duas portas para ajudar a prevenir a perda acidental de dados. Deve ativar a opção Valores nulos de fluxo tanto para o atributo de origem como para o correspondente mapeamento de destino.

Na criação do utilizador, um valor fonte nulo, vazio ou omitido não preenche o atributo alvo a menos que tenha configurado o valor padrão se nulo. Um valor padrão aplica-se apenas durante a criação. Durante uma atualização, o serviço de provisionamento apaga o valor de destino em vez de aplicar o valor predefinido definido no momento da criação.

Pré-requisitos

Antes de começar, certifique-se de que:

• Tens pelo menos a função de Administrador de Aplicações .
• Configurou uma aplicação de provisionamento e os seus mapeamentos de atributos.
• O atributo fonte existe no esquema da aplicação de provisionamento e possui um mapeamento de atributo alvo. Para saber mais, consulte Personalizar mapeamentos de atributos do Microsoft Entra.

Para o provisionamento de entrada orientado por API para o Active Directory no local, reveja os pré-requisitos adicionais de função e servidor, e depois configure o agente de provisionamento e a ligação ao Active Directory.

Ativar o fluxo de valor nulo para o atributo fonte

Primeiro, configure o atributo do esquema de origem para permitir o fluxo de valores nulos. O nome do editor de esquema de origem varia consoante a integração de provisionamento.

1. Inicia sessão no centro de administração Microsoft Entra pelo menos como Administrador de Aplicações.
2. Navegue para Entra ID>Aplicações Empresariais.
3. Procure e selecione a sua aplicação de provisionamento.
4. Selecione Aprovisionamento>.
5. Abre o mapeamento de atributos para o objeto que queres configurar.
6. Expanda as opções avançadas e depois selecione a opção para editar a lista de atributos de origem. O nome da opção identifica o sistema de origem ou o conector.
7. Na coluna Valores nulos de fluxo, selecione a caixa de verificação de cada atributo de origem que possa apagar o respetivo atributo de destino mapeado.
8. Selecione Guardar.

Ativar o fluxo de valor nulo no mapeamento alvo

De seguida, ative o fluxo de valor nulo para cada mapeamento de atributo alvo correspondente.

1. Voltar à página de mapeamento de atributos .
2. Seleciona o mapeamento do atributo alvo que queres limpar.
3. Selecione valores nulos de fluxo.
4. Selecione OK para fechar o editor de mapas.
5. Seleciona Guardar para guardar os mapeamentos de atributos.
6. Repita estes passos para cada atributo alvo que tenha de aceitar um valor nulo.

Ambas as definições são obrigatórias. Se os valores nulos do fluxo não forem selecionados para o atributo do esquema de origem ou para o mapeamento de destino, o serviço de provisionamento não utiliza o valor nulo ou vazio da fonte para limpar o atributo de destino.

Exemplo de provisionamento orientado por API

O exemplo seguinte mostra como configurar o provisionamento de entrada orientado por API para limpar valores de atributos e enviar valores nulos ou vazios num /bulkUpload pedido.

Ativar o fluxo de valor nulo no esquema de origem

Para provisionamento orientado por API, expanda as opções avançadas e depois selecione Editar atributos de utilizador da API. Localize a coluna de valores nulos Flow e selecione os atributos de origem que podem enviar valores nulos ou vazios. No exemplo abaixo, os valores nulos de fluxo estão ativados para os atributos division de extensão SCIM e department. Esta configuração instrui o serviço de provisionamento a processar valores nulos ou vazios para estes atributos e a avaliar o mapeamento de atributos alvo para fluxo nulo.

Ativar o fluxo de valor nulo no mapeamento alvo

Abra cada mapeamento de atributo alvo correspondente e selecione valores nulos de fluxo. O exemplo abaixo mapeia o atributo de extensão SCIM de origem department para o atributo department do Active Directory e ativa o fluxo de valores nulos para que, quando o atributo SCIM de origem for nulo ou estiver vazio, o valor do atributo department seja limpo no Active Directory.

Enviar valores nulos ou vazios

Inclua o atributo num /bulkUpload pedido e defina o seu valor para JSON null ou uma string vazia.

O excerto seguinte limpa, para o utilizador correspondente, os valores existentes department e division:

{
  "schemas": [
    "urn:ietf:params:scim:api:messages:2.0:BulkRequest"
  ],
  "Operations": [
    {
      "method": "POST",
      "bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
      "path": "/Users",
      "data": {
        "schemas": [
          "urn:ietf:params:scim:schemas:core:2.0:User",
          "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
        ],
        "externalId": "701984",
        "userName": "bjensen@example.com",
        "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
          "department": null,
          "division": ""
        }
      }
    }
  ],
  "failOnErrors": null
}

Use os nomes dos atributos de origem do esquema da sua aplicação de provisionamento. Certifique-se de que o pedido contém o atributo correspondente exigido pela sua configuração, como externalId.

Para obter instruções para submeter o pedido, consulte Início rápido para aprovisionamento de entrada orientado por API com o Graph Explorer ou Início rápido para aprovisionamento de entrada orientado por API com cURL.

Verifique se o atributo foi eliminado

Depois de o serviço de provisionamento processar o pedido, verifique o resultado nos registos de provisionamento e no diretório de destino.

1. Na tua aplicação de provisionamento, seleciona Registos de Provisionamento.

2. Abra o evento de provisionamento para o utilizador.

3. Selecione o separador Propriedades Modificadas .

4. Confirme que o atributo alvo mostra um novo valor vazio.

   

5. Verifique se o atributo já não tem valor no objeto no sistema de destino.

Neste exemplo do Active Directory no local, o atributo de origem da API division é mapeado para o atributo de destino company. Para o Active Directory no local, o serviço de provisionamento remove o valor do atributo em vez de escrever uma string vazia.

Resolver problemas na limpeza de valores de atributos

Use as seguintes orientações se o atributo alvo não for eliminado.

Passos seguintes

• Personalizar os mapeamentos de atributos do Microsoft Entra
• Conceitos de provisionamento de entrada orientados por API
• Perguntas frequentes sobre o provisionamento de entrada orientado por API
• Resolução de problemas do provisionamento inbound orientado por API