Atualizar federatedTokenValidationPolicy

Namespace: microsoft.graph

Atualize as propriedades de um objeto federatedTokenValidationPolicy .

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissão com privilégios mínimos Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) Policy.ReadWrite.FedTokenValidation Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Policy.ReadWrite.FedTokenValidation Indisponível.

Importante

Em cenários delegados com contas corporativas ou de estudante, o usuário conectado deve receber uma função do Microsoft Entra com suporte ou uma função personalizada com uma permissão de função com suporte. As seguintes funções privilegiadas têm suporte para esta operação:

  • Administrador de Segurança
  • Administrador de Identidade Híbrida
  • Administrador de provedor de identidade externo

Solicitação HTTP

PUT /policies/federatedTokenValidationPolicy

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Importante

Se você definir rootDomains como enumerated ou allManagedAndEnumeratedFederated, deverá especificar @odata.type como #microsoft.graph.enumeratedDomains na propriedade validatingDomains . Omitir o discriminador nesses casos retorna HTTP 400 Bad Request.

Para qualquer outro rootDomains valor (none, all, allFederated, allManaged), o subtipo é inferido como microsoft.graph.allDomains, portanto, @odata.type é opcional.

Propriedade Tipo Descrição
validatingDomains validatingDomains Domínios verificados que o Microsoft Entra valida se o domínio raiz da conta federada corresponde ao domínio raiz da conta mapeada do Microsoft Entra. Obrigatório.

Resposta

Se for bem-sucedido, esse método retornará um código de 200 OK resposta e um objeto federatedTokenValidationPolicy atualizado no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

PUT https://graph.microsoft.com/v1.0/policies/federatedTokenValidationPolicy
Content-Type: application/json

{
  "validatingDomains": {
    "@odata.type": "#microsoft.graph.enumeratedDomains",
    "rootDomains": "enumerated",
    "domainNames": ["contoso.com", "fabrikam.com"]
  }
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.federatedTokenValidationPolicy",
  "id": "932b8f7f-68c1-6fe5-59ab-56e1ff752f30",
  "deletedDateTime": null,
  "validatingDomains": {
    "@odata.type": "#microsoft.graph.enumeratedDomains",
    "rootDomains": "enumerated",
    "domainNames": ["contoso.com", "fabrikam.com"]
  }
}
  • Última atualização em