OfficeRuntime.Auth interface
Interface qui contient des API liées à l’autorisation.
Remarques
Les méthodes de cette interface sont équivalentes à celles de l’interface Office.auth. Si de nouveaux types d’authentification sont ajoutés à l’avenir, ils seront ajoutés uniquement à l’interface Office.auth
. Par souci de simplicité, les exemples de code de la documentation utilisent Office.auth
.
Méthodes
get |
Appelle le point de terminaison Azure Active Directory V 2.0 pour obtenir un jeton d’accès à l’application web de votre complément. Permet aux compléments d’identifier les utilisateurs. Le code côté serveur peut utiliser ce jeton pour accéder à Microsoft Graph pour l’application web du complément à l’aide du flux OAuth « au nom de ». Cette API nécessite une configuration à authentification unique qui relie le complément à une application Azure. Les utilisateurs Office se connectent à des comptes professionnels et des comptes Microsoft. Microsoft Azure renvoie des jetons destinés aux deux types de comptes utilisateur afin d’accéder aux ressources dans Microsoft Graph. |
Détails de la méthode
getAccessToken(options)
Appelle le point de terminaison Azure Active Directory V 2.0 pour obtenir un jeton d’accès à l’application web de votre complément. Permet aux compléments d’identifier les utilisateurs. Le code côté serveur peut utiliser ce jeton pour accéder à Microsoft Graph pour l’application web du complément à l’aide du flux OAuth « au nom de ». Cette API nécessite une configuration à authentification unique qui relie le complément à une application Azure. Les utilisateurs Office se connectent à des comptes professionnels et des comptes Microsoft. Microsoft Azure renvoie des jetons destinés aux deux types de comptes utilisateur afin d’accéder aux ressources dans Microsoft Graph.
getAccessToken(options?: AuthOptions): Promise<string>;
Paramètres
- options
- OfficeRuntime.AuthOptions
Facultatif. Accepte un AuthOptions
objet pour définir des comportements d’authentification.
Retours
Promise<string>
Promesse au jeton d’accès.
Remarques
Applications : Excel, Outlook, PowerPoint, Word
Important:
Dans Outlook, cette API n’est pas prise en charge si vous chargez un complément dans une boîte aux lettres Outlook.com ou Gmail.
Dans Outlook sur le web, cette API n’est pas prise en charge si vous utilisez le navigateur Safari. Cela entraîne l’erreur 13001 (« L’utilisateur n’est pas connecté à Office »).
Dans Outlook sur le web, si vous utilisez la méthode displayDialogAsync pour ouvrir un dialogue, vous devez fermer la boîte de dialogue avant de pouvoir appeler
getAccessToken
.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour