Office.Auth interface

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 utilizadores. O código do lado do servidor pode utilizar este token para aceder ao Microsoft Graph para a aplicação Web do suplemento através do fluxo OAuth "em nome de". Essa API exige uma configuração de logon única que preencha o suplemento para um aplicativo do Azure. Os utilizadores do Office iniciam sessão com Contas Organizacionais e Contas 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

Retornos

Prometa ao token de acesso.

Comentários

Aplicações: Excel, OneNote, Outlook, PowerPoint Word

Conjunto de requisitos: IdentityAPI 1.3

Importante:

• No Outlook, esta API não é suportada se carregar um suplemento numa caixa de correio Outlook.com ou Gmail.

• No Outlook na Web, esta API não é suportada se utilizar o Firefox com a Proteção de Controlo Avançada ativada. Isto resulta no erro 13001 ("O utilizador não tem sessão iniciada no Office").

• No Outlook na Web e no novo Outlook no Windows, se utilizar o método displayDialogAsync para abrir uma caixa de diálogo, tem de fechar a caixa de diálogo antes de poder chamar getAccessToken.

• Num suplemento de ativação baseado em eventos do Outlook, esta API é suportada no Outlook no Windows a partir da Versão 2111 (Compilação 14701.20000). Para obter um token de acesso em compilações mais antigas, utilize OfficeRuntime.auth.getAccessToken como alternativa. Para obter mais informações, veja Ativar o início de sessão único (SSO) nos suplementos do Outlook que utilizam a ativação baseada em eventos.

Exemplos

try{
    const accessToken = await Office.auth.getAccessToken({
        allowSignInPrompt: true,
        allowConsentPrompt: true,
        forMSGraphAccess: true,
    });
} catch (error) {
    console.log("Error obtaining token", error);
}

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 utilizadores. O código do lado do servidor pode utilizar este token para aceder ao Microsoft Graph para a aplicação Web do suplemento através do fluxo OAuth "em nome de".

Importante: no Outlook, esta API não é suportada se o suplemento for carregado numa caixa de correio Outlook.com ou gmail.

Aviso: getAccessTokenAsync foi preterido. Em vez disso, utilize Office.auth.getAccessToken .

getAccessTokenAsync(options?: AuthOptions, callback?: (result: AsyncResult<string>) => void): void;

Parâmetros

Retornos

Comentários

Aplicações: Excel, OneNote, Outlook, PowerPoint Word

Conjunto de requisitos: IdentityAPI 1.3

Essa API exige uma configuração de logon única que preencha o suplemento para um aplicativo do Azure. Os utilizadores do Office iniciam sessão com Contas Organizacionais e Contas Microsoft. O Microsoft Azure retorna tokens destinados a ambos os tipos de conta de usuário para acessar recursos no Microsoft Graph.

Exemplos

Office.context.auth.getAccessTokenAsync(function(result) {
    if (result.status === Office.AsyncResultStatus.Succeeded) {
        const token = result.value;
        // ...
    } else {
        console.log("Error obtaining token", result.error);
    }
});

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 utilizadores. O código do lado do servidor pode utilizar este token para aceder ao Microsoft Graph para a aplicação Web do suplemento através do fluxo OAuth "em nome de".

Importante: no Outlook, esta API não é suportada se o suplemento for carregado numa caixa de correio Outlook.com ou gmail.

Aviso: getAccessTokenAsync foi preterido. Em vez disso, utilize Office.auth.getAccessToken .

getAccessTokenAsync(callback?: (result: AsyncResult<string>) => void): void;

Parâmetros

Retornos

Comentários

Aplicações: Excel, OneNote, Outlook, PowerPoint Word

Conjunto de requisitos: IdentityAPI 1.3

Essa API exige uma configuração de logon única que preencha o suplemento para um aplicativo do Azure. Os utilizadores do Office iniciam sessão com Contas Organizacionais e Contas Microsoft. O Microsoft Azure retorna tokens destinados a ambos os tipos de conta de usuário para acessar recursos no Microsoft Graph.

Obtém informações sobre o utilizador com sessão iniciada. O suplemento pode transmitir estas informações à biblioteca de autenticação da Microsoft (MSAL.js) para obter um token de acesso para a sessão atual.

getAuthContext(): Promise<AuthContext>;

Retornos

Prometa ao objeto AuthContext.

Comentários

Anfitriões: Excel, OneNote, Outlook, PowerPoint Word

Conjunto de requisitos: NestedAppAuth 1.1

Exemplos

try{
    const authContext = await Office.auth.getAuthContext();
    console.log(authContext.userPrincipalName);
} catch (error) {
    console.log("Error obtaining token", error);
}