Excel AddIn Office.auth.getAccessToken() returns exception

Question

We habve an Excel AddIn. We want to know which user is using it.

SO failed OSF.DDA.Error {name: 'Nicht unterstützte API.', message: 'Die Identitäts-API wird für dieses Add-In nicht unterstützt.', code: 13000}

Our manifest includes:

<WebApplicationInfo>
  <Id>20182508-ad3b-4409-8cf3-cc010209fb91</Id>
  <Resource>api://lpsng.rsj.de/20182508-ad3b-4409-8cf3-cc010209fb91</Resource>
  <Scopes>
      <Scope>openid</Scope>
      <Scope>profile</Scope>
      <Scope>access_as_user</Scope>
  </Scopes>
</WebApplicationInfo>
<Sets DefaultMinVersion="1.1">
  <Set Name="ExcelApi" MinVersion="1.1"/>
  <Set Name="IdentityAPI" MinVersion="1.3"/>
</Sets>

Answer 1

Das Problem tritt auf, weil die Office Identity API (Office.context.auth.getAccessToken) in der aktuellen Excel-Laufzeitumgebung bzw. Plattform nicht unterstützt wird, obwohl sie im Manifest definiert ist. Dies kann in bestimmten Szenarien vorkommen, z. B. bei älteren Office-Versionen, auf Mac-Systemen, in Desktop-Umgebungen ohne moderne WebView2-Unterstützung oder bei bestimmten Sideload-/Testkonfigurationen. Um das Problem zu beheben, sollte zunächst eine Laufzeitprüfung mit Office.context.requirements.isSetSupported('IdentityAPI', '1.3') eingebaut werden, um Fehler zu vermeiden. Da die Unterstützung der Identity API jedoch nicht in allen Umgebungen zuverlässig ist, empfiehlt es sich, stattdessen eine robuste Authentifizierung über die Microsoft Authentication Library (MSAL) zu implementieren und die Benutzerinformationen über Microsoft Graph (z. B. /me-Endpunkt) abzurufen. Zusätzlich sollte sichergestellt werden, dass die App-Registrierung in Azure AD (Entra ID) korrekt konfiguriert ist (Berechtigungen wie openid, profile, User.Read) und die erforderlichen Admin-Zustimmungen erteilt wurden. Dieser Ansatz gewährleistet eine konsistente und plattformunabhängige Benutzeridentifikation für das Excel-Add-In.