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 de 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, scopes usando-se o 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 application.

Propriedades

Propriedade Tipo Descrição
adminConsentDescription Cadeia de caracteres Uma descrição das permissões delegadas, destinadas a ser lidas por um administrador concedendo 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 concedendo 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 Ao criar ou atualizar 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 que usuários não administradores consentam em nome de si mesmos ou se um consentimento de administrador sempre deve ser necessário. Embora o Microsoft Graph define o requisito de consentimento padrão para cada permissão, o administrador de locatários pode substituir o comportamento em sua organização (permitindo, restringindo ou limitando o consentimento do usuário para essa permissão delegada). Para obter mais informações, consulte Configure how users consent to applications.
userConsentDescription String Uma descrição das permissões delegadas, destinadas a ser lidas por um usuário concedendo 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 String Um título para a permissão, destinado a ser lido por um usuário concedendo 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.
value 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 , bem como caracteres nos intervalos 0-9e . A-Z a-z Qualquer outro caractere, incluindo o caractere de espaço, não é permitido. Pode não começar com ..

Representação JSON

Veja a seguir uma representação JSON do recurso

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