tipo de recurso permissionScope

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 a definição de uma permissão delegada.

As permissões delegadas podem ser solicitadas por aplicativos cliente que precisam de um token de acesso à API que definiu as permissões. As permissões delegadas podem ser solicitadas dinamicamente, usando o scopes parâmetro em uma solicitação de autorização para o plataforma de identidade da Microsoft ou estaticamente, por meio da coleção requiredResourceAccess no objeto do aplicativo.

Propriedades

Propriedade Tipo Descrição
adminConsentDescription Cadeia de caracteres Uma descrição das permissões delegadas, destinadas a ser lidas por um administrador que concede a permissão em nome de todos os usuários. Este texto aparece em experiências de consentimento de administrador em todo o locatário.
adminConsentDisplayName Cadeia de caracteres O título da permissão, destinado a ser lido por um administrador que concede a permissão em nome de todos os usuários.
id Guid Identificador de permissão delegado exclusivo dentro da coleção de permissões delegadas definidas para um aplicativo de recurso.
isEnabled Booliano Quando você cria ou atualiza uma permissão, essa propriedade deve ser definida como true (que é o padrão). Para excluir uma permissão, essa propriedade deve primeiro ser definida como false. Nesse ponto, em uma chamada subsequente, a permissão pode ser removida.
type Cadeia de caracteres Os valores possíveis são: User e Admin. Especifica se essa permissão delegada deve ser considerada segura para usuários não administradores consentirem em nome de si mesmos ou se um consentimento do administrador deve ser sempre necessário. Embora o Microsoft Graph defina o requisito de consentimento padrão para cada permissão, o administrador do locatário pode substituir o comportamento em sua organização (permitindo, restringindo ou limitando o consentimento do usuário a essa permissão delegada). Para obter mais informações, consulte Configurar como os usuários consentem com aplicativos.
userConsentDescription Cadeia de caracteres Uma descrição das permissões delegadas, destinadas a ser lidas por um usuário que concede a permissão em seu próprio nome. Este texto aparece em experiências de consentimento em que o usuário está consentindo apenas em nome de si mesmo.
userConsentDisplayName Cadeia de caracteres Um título para a permissão, destinado a ser lido por um usuário que concede a permissão em seu próprio nome. Este texto aparece em experiências de consentimento em que o usuário está consentindo apenas em nome de si mesmo.
valor Cadeia de caracteres Especifica o valor a ser incluído na declaração scp (escopo) em tokens de acesso. Não deve exceder 120 caracteres de comprimento. Os caracteres permitidos são :`]@^'&(%$#!>?[;~<}+*,-.)/_|={:+, e os caracteres nos intervalos 0-9e . A-Za-z Qualquer outro caractere, incluindo o caractere espacial, não é permitido. Pode não começar com ..

Representação JSON

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

{
  "id": "Guid",
  "adminConsentDisplayName": "String",
  "adminConsentDescription": "String",
  "userConsentDisplayName": "String",
  "userConsentDescription": "String",
  "value": "String",
  "type": "String",
  "isEnabled": true
}