tipo de recurso appRole

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Representa uma função de aplicativo. Os aplicativos cliente podem solicitar funções de aplicativo. As funções de aplicativo também podem ser usadas para atribuir um aplicativo a usuários ou grupos em uma função especificada.

Para adicionar, atualizar ou remover funções de aplicativo para um aplicativo, atualize o aplicativo para o aplicativo ou serviço. As funções de aplicativo na entidade de aplicativo estarão disponíveis em todos os locatários em que o aplicativo é usado. Para definir funções de aplicativo que são aplicáveis somente em seu locatário (por exemplo, funções de aplicativo que representam funções personalizadas em sua instância de um aplicativo multilocatário), você também pode atualizar a entidade de serviço do aplicativo, para adicionar ou atualizar funções de aplicativo para a coleção appRoles .

Com appRoleAssignments, as funções de aplicativo podem ser atribuídas a usuários, grupos ou entidades de serviço de outros aplicativos.

Consulte Exemplo 2: Atualizar o appRoles de um aplicativo para obter um exemplo prático.

Propriedades

Propriedade Tipo Descrição
allowedMemberTypes String collection Especifica se essa função de aplicativo pode ser atribuída a usuários e grupos (definindo como ["User"]), a outro aplicativo (definindo como ["Application"], ou ambos (definindo como ["User", "Application"]). As funções de aplicativo que dão suporte à atribuição a entidades de serviço de outros aplicativos também são conhecidas como permissões de aplicativo. O valor "Aplicativo" só tem suporte para funções de aplicativo definidas em entidades de aplicativo .
description Cadeia de caracteres A descrição da função de aplicativo. Isso é exibido quando a função de aplicativo está sendo atribuída e, se a função de aplicativo funcionar como uma permissão de aplicativo, durante as experiências de consentimento.
displayName Cadeia de caracteres Nome de exibição para a permissão que aparece nas experiências de consentimento e atribuição de função do aplicativo.
id Guid Identificador de função exclusivo dentro da coleção appRoles . Você deve especificar um novo identificador GUID ao criar uma nova função de aplicativo.
isEnabled Booliano Quando você cria ou atualiza uma função de aplicativo, esse valor deve ser true. Para excluir uma função, primeiro isso deve ser definido como false. Nesse ponto, em uma chamada subsequente, essa função pode ser removida. O valor padrão é true.
origem Cadeia de caracteres Especifica se a função do aplicativo é definida no objeto de aplicativo ou na entidade servicePrincipal . Não deve ser incluído em nenhuma solicitação POST ou PATCH. Somente leitura.
value Cadeia de caracteres Especifica o valor a ser incluído na roles declaração em tokens de ID e tokens de acesso que autenticam um usuário atribuído ou entidade de serviço. Não deve exceder 120 caracteres. Os caracteres permitidos são :{#$!.-,+/*)(:'&%;<@?[>]^=|~_}+`, e os caracteres nos intervalos 0-9, A-Z, e .a-z Nenhum outro caractere, incluindo o caractere de espaço, é permitido. Não pode começar com ..

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "allowedMemberTypes": ["String"],
  "description": "String",
  "displayName": "String",
  "id": "Guid",
  "isEnabled": true,
  "origin": "String",
  "value": "String"
}
  • Última atualização em