Configurações de Atualização de Atributos de Usuário SCIM

Dan Justin 21 de set de 2026

Visão Geral

A integração SCIM do Fluid pode atualizar automaticamente os atributos de usuário no Fluid sempre que um valor correspondente for alterado no seu provedor de identidade (IdP — por exemplo, Microsoft Entra ID ou Okta).

📘 Nota Essas configurações de mapeamento de atributos SCIM estão desativadas por padrão. Como permitem que o SCIM sobrescreva campos do Fluid, a maioria dos clientes deve validar e consolidar seus dados do Active Directory previamente para evitar a sincronização de valores incorretos. Para habilitar o mapeamento de atributos no seu ambiente, entre em contato com o Suporte do Fluid em support@fluid.work ou com o seu Fluid Success Manager.

Quando o seu IdP provisiona ou atualiza um usuário, ele envia os atributos do usuário para o Fluid dentro do bloco de extensão empresarial SCIM:

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

O Fluid lê os atributos desse bloco e os grava nos campos correspondentes do Fluid.

⚠️ Importante O SCIM tem acesso de escrita a esse campo do Fluid. Quaisquer edições manuais feitas diretamente no Fluid em um campo controlado pelo SCIM poderão ser sobrescritas na próxima sincronização SCIM.

Atributos Configuráveis

Mapeie os seguintes nomes de atributos SCIM no seu IdP. Observe que o nome do atributo SCIM frequentemente difere do nome do campo do Fluid que ele atualiza. Os nomes dos atributos são correspondidos sem distinção entre maiúsculas e minúsculas, e um valor só é gravado quando não está vazio e difere do valor atual no Fluid.

Atributos do esquema principal

Estes vêm do esquema de usuário principal do SCIM (urn:ietf:params:scim:schemas:core:2.0:User), não da extensão empresarial.

Configuração	Atributo de Origem SCIM	Campo do Fluid Atualizado	Descrição
Nome e Sobrenome	`name.givenName`, `name.familyName`	Nome, Sobrenome	Define o nome e o sobrenome do usuário no Fluid.
E-mail	`emails`	Endereço de E-mail	Define o endereço de e-mail do usuário no Fluid a partir do valor de e-mail do SCIM.
Nome de Exibição	`displayName`	Nome de Exibição	Define o nome de exibição do usuário no Fluid.

Atributos da extensão empresarial

Estes são enviados dentro do bloco urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.

Configuração	Atributo de Origem SCIM	Campo do Fluid Atualizado	Descrição
ID do Funcionário	`employeeNumber`	Referência	Atualiza o valor de Referência no Fluid com base no valor `employeeNumber` do SCIM.
Função	`role`	Função do Usuário	Define a função do usuário no Fluid a partir do atributo `role` do SCIM.
Centro de Custo	`costCenter`	Centro de Custo	Define o centro de custo do usuário no Fluid a partir do valor `costCenter` do SCIM.
Gestor	`manager` / `managerId`	Gestor	Define o gestor do usuário no Fluid a partir do atributo `manager` do SCIM. Aceita um objeto (`manager.value`) ou uma string simples; o valor é resolvido para um usuário do Fluid por ID, nome de usuário, nome de exibição ou e-mail.
Organização	`organization`	Equipe	Define a Equipe do plano de recursos ativo do Fluid a partir do valor `Team` do SCIM.
Divisão	`division`	Divisão	Define a divisão do plano de recursos ativo do Fluid a partir do valor `division` do SCIM.
Departamento	`department`	Departamento	Define o departamento do plano de recursos ativo do Fluid a partir do valor `department` do SCIM.
País	`country`	País	Define o país do usuário no Fluid diretamente a partir de um valor `country` dedicado no SCIM.
Região	`region`	Localização	Define a localização do usuário no Fluid diretamente a partir de um valor `region` dedicado no SCIM.
Tabela de Tarifas	`rateCard`	Classificação	Define a classificação do usuário no Fluid a partir do valor `rateCard` do SCIM.
Tipo de Engajamento	`engagementType`	Tipo de Engajamento	Define o tipo de engajamento do usuário no Fluid a partir do valor `engagementType` do SCIM.

Exemplo de Payload

{
  "schemas": [
    "urn:ietf:params:scim:schemas:core:2.0:User",
    "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"
  ],
  "userName": "jane.smith@contoso.com",
  "active": true,
  "urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
    "costCenter": "4130",
    "division": "Platform",
    "department": "Software Development",
    "organization": "Engineering",
    "employeeNumber": "701984"
  }
}

Resultado: costCenter → Centro de Custo, division → divisão, department → departamento, organization → equipe, employeeNumber → Referência.

Mapeamento para uma Propriedade Personalizada do Fluid (avançado)

Se você precisar sincronizar um atributo que não está nas tabelas acima, o Fluid pode gravá-lo em qualquer propriedade personalizada de pessoa. Não há tela de mapeamento — o Fluid corresponde o nome do atributo SCIM à Chave ou Rótulo da propriedade personalizada (sem distinção entre maiúsculas e minúsculas, ignorando espaços). Entregue-o de uma das duas formas:

Dentro do bloco de extensão empresarial — qualquer atributo cujo nome corresponda a uma Chave/Rótulo de propriedade personalizada é capturado automaticamente; ou
Como uma extensão personalizada com namespace — uma chave de nível superior que começa com o URN empresarial seguido de um ponto, por exemplo, urn:ietf:params:scim:schemas:extension:enterprise:2.0:User.TeamName.

Para usar isso:

Crie a propriedade personalizada de pessoa no Fluid.
Mapeie o atributo de origem do seu IdP para um atributo SCIM cujo nome corresponda exatamente à Chave ou ao Rótulo da propriedade.

Notas Importantes

Nomes exatos são importantes — um erro de digitação no mapeamento do IdP (por exemplo, costCentre em vez de costCenter) é ignorado silenciosamente. Nenhum erro é gerado; o campo simplesmente não será atualizado.