WebApplicationInfo-Element

  • Artikel

Dieses Element unterstützt einmaliges Anmelden (Single Sign-On, SSO) in Office-Add-Ins. Es enthält Informationen zu dem Add-In als:

  • Eine OAuth 2.0-Ressource , für die die Office-Clientanwendung möglicherweise Berechtigungen benötigt.
  • OAuth 2.0-Client, der möglicherweise Berechtigungen für Microsoft Graph benötigt

Add-In-Typ: Aufgabenbereich, E-Mail, Inhalt

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Inhalt 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im Manifest.

Diesen Anforderungssätzen zugeordnet:

Hinweis

Die API für einmaliges Anmelden wird derzeit für Word, Excel, Outlook und PowerPoint unterstützt. Weitere Informationen dazu, wo die Single Sign-On-API derzeit unterstützt wird, finden Sie unter Identity-API-Anforderungssätze. Wenn Sie mit einem Outlook-Add-In arbeiten, müssen Sie die moderne Authentifizierung für den Microsoft 365-Mandanten aktivieren. Informationen dazu finden Sie unter Aktivieren oder Deaktivieren der modernen Authentifizierung für Outlook in Exchange Online.

<WebApplicationInfo> ist ein untergeordnetes Element des VersionOverrides-Elements im Manifest.

Untergeordnete Elemente

Element Erforderlich Beschreibung
<Id> Ja Die Anwendungs-ID des zugeordneten Dienstes des Add-Ins, der im Azure Active Directory v 2.0-Endpunkt registriert ist.
<Ressource> Ja Gibt den Anwendungs-ID-URI des Add-Ins an, der im Azure Active Directory v2.2.0-Endpunkt registriert ist.
Scopes Ja Gibt die Berechtigungen an, die das Add-In für eine Ressource benötigt, z. B. Microsoft Graph.

Beispiel für das Element „WebApplicationInfo“

<OfficeApp>
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
    ...
    <WebApplicationInfo>
      <Id>12345678-abcd-1234-efab-123456789abc</Id>
      <Resource>api://contoso.com/12345678-abcd-1234-efab-123456789abc</Resource>
      <Scopes>
        <Scope>Files.Read.All</Scope>
        <Scope>offline_access</Scope>
        <Scope>openid</Scope>
        <Scope>profile</Scope>
      </Scopes>
    </WebApplicationInfo>
  </VersionOverrides>
...
</OfficeApp>