API de herança de função do usuário

. Herança da função do usuário A API fornece endpoints que permitem que você veja as funções herdadas por um usuário específico.

Esta API requer o plug-in Contextual Security: Role Management V2 REST API (com.glide.role_management.inh_count.rest_api), ativado automaticamente em novas instâncias a partir da versão Jakarta, ou o plug-in Contextual Security: Role Management Enhancements REST API, ativado automaticamente a partir da versão Geneva. A REST API Contextual Security: Role Management V2 depende do plug-in Contextual Security: Role Management V2 (com.glide.role_management.inh_count).

A função de um usuário pode ser concedida diretamente, herdada de outras funções ou herdada de grupos. Você deve ter a função user_admin para acessar esta API.

Herança de função do usuário - OBTENHA /global/user_role_inheritance

Retorna as funções concedidas e herdadas de um usuário especificado.

Formato de URL

URL com controle de versão: /api/global//user_role_inheritance

URL padrão: /api/global/user_role_inheritance

Nota:

As versões disponíveis são especificadas em REST API Explorer . Para REST APIs com script, há informações adicionais de versão no Formulário de serviço REST com script .

Parâmetros de solicitação compatíveis

Tabela 1. Parâmetros de caminho

Nome	Descrição
api_version	Opcional. Versão do endpoint a ser acessado. Por exemplo, v1 ou v2 . Especifique este valor somente para usar uma versão de endpoint diferente da mais recente. Tipo de dados: Cadeia de caracteres

Tabela 2. Parâmetros de consulta

Nome	Descrição
user_sysid	Obrigatório. Sys_id do usuário para o qual retornar informações de função.

Tabela 3. Solicitar parâmetros do corpo (XML ou JSON)

Nome	Descrição
Nenhum(a)

Cabeçalhos

Os cabeçalhos de solicitação e resposta a seguir se aplicam somente a esta ação HTTP ou se aplicam a esta ação de maneira distinta. Para obter uma lista de cabeçalhos gerais usados na REST API, consulte Cabeçalhos de REST API compatíveis .

Tabela 4. Cabeçalhos da solicitação

Cabeçalho	Descrição
Aceitar	Formato de dados do corpo da resposta. Tipos compatíveis: application/jsonou application/xml. Padrão: application/json

Tabela 5. Cabeçalhos de resposta

Cabeçalho	Descrição
Nenhum(a)

Códigos de status

Os seguintes códigos de status se aplicam a esta ação HTTP. Para obter uma lista de possíveis códigos de status usados na REST API, consulte Códigos de resposta HTTP da REST API .

Tabela 6. Códigos de status

Código do status	Descrição
200	Bem-sucedido. A solicitação foi processada com sucesso.
400	Solicitação Incorreta. Um tipo de solicitação incorreto ou uma solicitação malformada foi detectada.
401	Não autorizado. As credenciais do usuário estão incorretas ou não foram aprovadas.
404	Não encontrado. O item solicitado não foi encontrado.
500	Erro interno do servidor. Ocorreu um erro inesperado ao processar a solicitação. A resposta contém informações adicionais sobre o erro.

Parâmetros do corpo da resposta (JSON ou XML)

Nome	Descrição
from_group	Lista de funções herdadas de grupos que têm funções. Tipo de dados: Matriz
from_role	Lista de funções concedidas diretamente ou herdadas de outras funções. Tipo de dados: Matriz
user_name	Nome completo do usuário. Tipo de dados: Cadeia de caracteres

Solicitação de cURL de amostra

curl "https://instance.service-now.com/api/global/user_role_inheritance?user_sysid=62826bf03710200044e0bfc8bcbe5df1" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

{
  "result": {
    "user_name": "abel.tuter",
    "from_group": [
      "[Azure Operators]/sn_azure.operator",
      "[Azure Operators]/sn_azure.operator/sn_azure.user"
    ],
    "from_role": [
      "/snc_internal",
      "/cloud_user",
      "/cloud_user/pa_viewer",
      "/cloud_user/sn_azure.user",
      "/cloud_user/aws_user"
    ]
  }
}