Compartilhar via

OfficeRuntime.Auth interface

  • Referência
Pacote:
office-runtime

Interface que contém APIs relacionadas à autorização.

Comentários

Os métodos nessa interface são equivalentes aos da interface Office.auth. Se novos tipos de autenticação forem adicionados no futuro, eles só serão adicionados à Office.auth interface. Para simplificar, os exemplos de código em toda a documentação usam Office.auth.

Métodos

getAccessToken(options)

Chama o ponto de extremidade do Azure Active Directory V 2.0 para obter um token de acesso para o aplicativo Web do seu suplemento. Permite que os suplementos identifiquem os usuários. O código do lado do servidor pode usar esse token para acessar o Microsoft Graph para o aplicativo Web do suplemento usando o fluxo OAuth "em nome do". Essa API exige uma configuração de logon única que preencha o suplemento para um aplicativo do Azure. Os usuários do Office entram com Contas Organizacionais e Contas da Microsoft. O Microsoft Azure retorna tokens destinados a ambos os tipos de conta de usuário para acessar recursos no Microsoft Graph.

Detalhes do método

getAccessToken(options)

Chama o ponto de extremidade do Azure Active Directory V 2.0 para obter um token de acesso para o aplicativo Web do seu suplemento. Permite que os suplementos identifiquem os usuários. O código do lado do servidor pode usar esse token para acessar o Microsoft Graph para o aplicativo Web do suplemento usando o fluxo OAuth "em nome do". Essa API exige uma configuração de logon única que preencha o suplemento para um aplicativo do Azure. Os usuários do Office entram com Contas Organizacionais e Contas da Microsoft. O Microsoft Azure retorna tokens destinados a ambos os tipos de conta de usuário para acessar recursos no Microsoft Graph.

getAccessToken(options?: AuthOptions): Promise<string>;

Parâmetros

options
OfficeRuntime.AuthOptions

Opcional. Aceita um AuthOptions objeto para definir comportamentos de logon.

Retornos

Promise<string>

Prometa ao token de acesso.

Comentários

Aplicativos: Excel, Outlook, PowerPoint, Word

Importante:

  • No Outlook, essa API não terá suporte se você carregar um suplemento em uma caixa de correio Outlook.com ou Gmail.

  • Em Outlook na Web, essa API não terá suporte se você usar o navegador Safari. Isso resulta no erro 13001 ("O usuário não está conectado ao Office").

  • No Outlook na Web, se você usar o método displayDialogAsync para abrir uma caixa de diálogo, deverá fechar a caixa de diálogo antes de poder chamar getAccessToken.