Facebook Login for Business

Facebook Login for Business ist die bevorzugte Authentifizierungs- und Autorisierungslösung für Tech-Anbieter*innen und Entwickler*innen von Business-Apps, die Zugriff auf die Assets ihrer Geschäftskund*innen benötigen. Es stellt eine Alternative zu Facebook Login dar. Wenn du kein*e Tech-Anbieter*in bist oder keine Business-App zur Nutzung durch andere Unternehmen erstellst, verwende als Authentifizierungslösung stattdessen Facebook Login.

Vorteile

Im Gegensatz zu Facebook Login gestattet dir Facebook Login for Business, den Typ des Zugriffsschlüssels, die Asset-Typen sowie die Berechtigungen anzugeben, die deine App benötigt, und diese als Satz (Konfiguration) zu speichern. Du kannst diesen Satz dann deinen Geschäftskund*innen anzeigen lassen, die den Vorgang abschließen und deiner App Zugriff auf ihre Business-Assets gewähren können. Ein Unternehmen kann dir damit keine Berechtigung für bestimmte Informationskategorien gewähren, die typischerweise für eine Business-App nicht erforderlich sind. Du hast die Wahl zwischen verschiedenen Zugriffsschlüsseln, basierend auf den Anforderungen deiner App.

Die meisten Apps, die auf Nutzungsdaten zugreifen können, werden einer fortlaufenden Überprüfung unterzogen. Wenn eine App jedoch ausschließlich Unternehmensberechtigungen/-funktionen benötigt, bist du möglicherweise berechtigt, Facebook Login for Business zu installieren. Somit ist es für deine App weniger notwendig, die fortlaufende Überprüfung zu durchlaufen.

Unterstützte Berechtigungen

Du kannst von deinen Geschäftskund*innen die folgenden Berechtigungen anfordern. Beachte, dass dein*e Geschäftskund*in bei Facebook Login for Business anders als bei Facebook Loginalle Berechtigungen gewähren muss, die du in deiner Konfiguration angibst.

Verfügbare Features

• Standardzugriff für das Anzeigenmanagement
• Zugriff auf Nutzungsprofil mit Business-Assets
• Groups API
• Zugriff auf öffentliche Instagram-Inhalte
• Live Video API
• Seitenerwähnungen
• Zugriff auf öffentliche Seiteninhalte
• Zugriff auf öffentliche Metadaten von Seiten
• Menschliche Mitarbeiter*innen

Verfügbare Produkte

• App Ads
• App-Events
• App Links
• Audience Network
• Commerce
• Conversions-API für Unternehmensnachrichten
• Facebook Pixel
• Facebook Extensions SDK
• Fundraiser API
• Groups API
• Instagram Graph API (ohne Instagram Basic Display API)
• Jobs
• Pages API
• Marketing API
• Messenger
• Meta Business Extension
• Teilen
• ThreatExchange
• Web-Zahlungen
• Webhooks
• WhatsApp Business Platform

Unterstützte Zugriffsschlüssel

Mithilfe von Facebook Login for Business kannst du entweder Business-Integration-Systemnutzer-Zugriffsschlüssel oder Nutzungs-Zugriffsschlüssel abrufen. Beachte, dass deine aktuellen Zugriffsschlüssel nicht vom Wechsel zu Facebook Login for Business betroffen sind.

Business-Integration-Systemnutzer-Zugriffsschlüssel

Business-Integration-Systemnutzer-Zugriffsschlüssel werden von Facebook Login for Business erzeugt und sollten verwendet werden, wenn deine App programmgesteuerte, automatisierte Aktionen für die Anzeigenobjekte oder Seiten deiner Geschäftskund*innen durchführt, ohne auf die Eingabe eines*einer App-Nutzer*in angewiesen zu sein oder eine erneute Authentifizierung zu einem späteren Zeitpunkt zu erfordern. Zum Beispiel:

• Stündliche, automatisierte Server-zu-Server-Aufrufe der Conversion API
• Senden automatisierter Antworten als eine Seite.
• Kontinuierliche, automatisierte Updates von Produktkatalogbeständen.
• Automatisierter Abruf von Insights zu Anzeigen.

So erhältst du Business-Integration-Systemnutzer-Zugriffsschlüssel von deinen Geschäftskund*innen:

• Deine App kann keine Logins von mobilen Oberflächen (wie Android, iOS usw.) anfordern.
• Der*die Geschäftskund*in, der*die den Facebook Login for Business-Vorgang abschließt, muss ein Meta-Unternehmenskonto besitzen oder bereit zur Erstellung eines solchen sein.
• Deine App muss einem Meta-Unternehmenskonto zugeordnet sein, über das du die uneingeschränkte Kontrolle besitzt. Dies muss von deinem Meta-Unternehmenskonto getrennt sein, welches deinem*deiner Geschäftskund*in gehört.
• Der Business-Integration-Systemnutzer-Zugriffsschlüssel wird erstellt/aktualisiert und an dich gesendet, wenn ein*e Endnutzer*in die App-Installation abschließt.

Um den Vorgang rund um den Business-Integration-Systemnutzer-Zugriffsschlüssel zu testen, muss der Tester eine Rolle in der App innehaben.

Granulare Business-Integration-Systemnutzer-Zugriffsschlüssel

Für bestimmte Tech-Anbieter stehen mehrere granulare Business-Integration-Systemnutzer-Zugriffsschlüssel pro Kundenunternehmen zur Verfügung, um die Skalierbarkeit/Sicherheit des Betriebs zu verbessern. Dies betrifft in der Regel größere Organisationen, die ggf. unterschiedliche Zugriffskonfigurationen für unterschiedliche Zwecke oder Abteilungen benötigen, statt den einen Business-Integration-Systemnutzer-Zugriffsschlüssel pro Kundenunternehmen zu nutzen.

• Auch granulare Zugriffsschlüssel gelten spezifisch für das Business eines Kundenunternehmens. Sie können nicht in unterschiedlichen Kundenunternehmen geteilt oder abgerufen werden.
• Scope und Assetliste von granularen Zugriffsschlüsseln sollten eine Teilmenge des originalen Business-Integration-Systemnutzer-Zugriffsschlüssels darstellen.
• Falls ein Zugriffsschlüssel kompromittiert wird, ist nur das spezifische Kundenunternehmen betroffen, anstelle aller Unternehmenskonten aller Kundenunternehmen. Das hilft bei der Isolierung potenzieller Sicherheitsvorfälle und entkoppelt die Abhängigkeiten zwischen Unternehmenskonten und/oder Kundenunternehmen.

Business Integration System User Access Token Management API

Mit diesem Endpunkt können Entwickler*innen ihre vorhandenen Systemnutzer-Zugriffsschlüssel wie folgt verwalten:

• Weitere granulare Systemnutzer-Zugriffsschlüssel anhand des vorhandenen Business-Integration-Systemnutzer-Zugriffsschlüssels erzeugen
• Vorhandene Business-Integration-Systemnutzer-Zugriffsschlüssel abrufen (Originalschlüssel und/oder granulare Schlüssel)

Parameter

Beispielanfrage

curl -i -X POST \ 
  'https://graph.intern.facebook.com/v17.0/2738613836382965/system_user_access_tokens?appsecret_proof=<app_secret_proof_sanitized>&
access_token=<access token sanitized>&   
system_user_id={system_user_id}&
fetch_only=true'

Beispielantwort

{
  "access_token": "{access_token}" 
}

Nutzungs-Zugriffsschlüssel

Wenn deine App in Echtzeit Aktionen ausführt, die auf den Eingaben des*der Nutzer*in basieren, sollten Nutzer*innen-Zugriffsschlüssel verwendet werden. Verwende z. B. einen Nutzer*innen-Zugriffsschlüssel, wenn ein*e Nutzer*in in deiner App Text eingeben und auf einen Button klicken muss, um Inhalte auf seiner*ihrer Seite zu posten. Außerdem sollten Nutzer*innen-Zugriffsschlüssel verwendet werden, wenn du eine API vorschreibst, für die Admin-Berechtigungen in einem Meta-Unternehmenskonto erforderlich sind.

Vergleich

Ungültigmachen von Zugriffsschlüsseln durch Kund*in

Deine Geschäftskund*innen können Business-Integration-Systemnutzer-Zugriffsschlüssel ungültig machen, indem sie zu Business Manager > Einstellungen > Unternehmenseinstellungen > Integrationen > Verknüpfte Apps navigieren und deine App entfernen.

Zum Ungültigmachen von Nutzungs-Zugriffsschlüsseln können deine Geschäftskund*innen die App entfernen, indem sie zu Facebook und dann zu Einstellungen und Privatsphäre > Einstellungen > Sicherheit und Login > Business-Integrationen navigieren und deine App entfernen.

App Installer/Login-Vorgang

Nutzungs-Zugriffsschlüssel – Login-Vorgang	Business-Integration-Systemnutzer-Zugriffsschlüssel – Login-Vorgang
Etwas ist schiefgelaufen Leider kann dieses Video nicht richtig abgespielt werden. Mehr dazu	Etwas ist schiefgelaufen Leider kann dieses Video nicht richtig abgespielt werden. Mehr dazu

Erste Schritte

Um Facebook Login for Business zu testen, musst du zunächst eine Test-App des Business-Typs erstellen, bei der Facebook Login for Business automatisch installiert wird.

Erstellen einer Konfiguration

Eine Konfiguration ist eine Gruppierung von Token-Typ, Business-Assets und Berechtigungen, die deine App von Geschäftskund*innen benötigt. Diese Gruppierung wird Nutzer*innen im Rahmen des Authentifizierungs- und Autorisierungsablaufs angezeigt, wenn sie die App installieren. Du kannst mehrere Konfigurationen erstellen und sie je nach den Anforderungen deiner App verschiedenen Gruppen von Benutzer*innen anzeigen. Zur Erstellung einer Konfiguration musst du Folgendes tun:

1. Lade deine App im App-Dashboard .
2. Füge das Produkt Facebook Login for Business hinzu.
3. Klicke auf Konfigurationen.
4. Klicke auf + Konfiguration erstellen.
5. Gib deiner Konfiguration einen Namen.
6. Wähle die Art des Zugriffsschlüssels, den du von deinen Geschäftskund*innen anfordern möchtest.
7. Wähle die Assets aus, auf die deine App zugreifen muss, wenn du den Systemnutzer-Zugriffsschlüssel ausgewählt hast.
8. Wähle die Berechtigungen aus, die deine App benötigt.
9. Klicke auf Erstellen.

Durch das Erstellen einer Konfiguration wird eine Konfigurations-ID erzeugt, die du dann mit unseren SDKs (oder manuell) verwenden kannst.

App-Dashboard-Konfiguration für einen Business-Integration-Systemnutzer-Zugriffsschlüssel:

Etwas ist schiefgelaufen

Leider kann dieses Video nicht richtig abgespielt werden.

Mehr dazu

Erstellen einer WhatsApp Embedded Signup-Konfiguration

WhatsApp Embedded Signup ist nur für Anbieter von Unternehmenslösungen (BSP) zugänglich.

1. Lade deine App im App-Dashboard .
2. Füge das Produkt Facebook Login for Business hinzu.
3. Klicke auf Konfigurationen.
4. Klicke auf + Konfiguration erstellen.
5. Gib deiner Konfiguration einen Namen.
6. Wähle WhatsApp Embedded Signup aus. Hiermit wird das Onboarding deiner App für das WhatsApp Embedded Signup aktiviert. Für das WhatsApp Embedded Signup sind nur Systemnutzer-Zugriffsschlüssel verwendbar.
7. Wähle die Ablaufzeit für den Schlüssel. Wir empfehlen 60 Tage. Somit wird das Risiko eines geleakten Schlüssels minimiert und die Sicherheit deines Systems wird verbessert.
8. Wähle die Assets aus, auf die deine App zugreifen muss. Dieser Schritt ist nur verfügbar, wenn du im vorherigen Schritt Systemnutzer-Zugriffsschlüssel ausgewählt hast. Die Auswahl von WhatsApp-Konten kann nicht aufgehoben werden.
9. Wähle die folgenden Berechtigungen für deine App aus: whatsapp_business_management und whatsapp_business_messaging.
10. Klicke auf Erstellen.

Erstellen einer IG-Konfiguration

Der Vorgang ist nur für die Nutzung der Instagram Graph API optimiert.

1. Lade deine App im App-Dashboard .
2. Füge das Produkt Facebook Login for Business hinzu.
3. Klicke auf Konfigurationen.
4. Klicke auf + Konfiguration erstellen.
5. Gib deiner Konfiguration einen Namen.
6. Wähle die Instagram Graph API, die das Onboarding deiner App in einen [Instagram-spezifischen Login-Vorgang] ermöglicht (https://developers.facebook.com/docs/instagram/business-login-for-instagram/). Es steht nur ein Nutzungs-Zugriffsschlüssel zur Verfügung.
7. Wähle die folgenden Berechtigungen für deine App:
8. Klicke auf Erstellen.

Aufrufen eines Login-Dialogs

Du kannst den Login-Dialog von Facebook Login for Business mit unseren SDKs aufrufen oder du kannst den Login-Dialog aufrufen, indem du den Login-Flow manuell erstellst.

Aufrufen mit unseren SDKs

Du kannst jedes unserer SDKs verwenden, um den Login-Dialog aufzurufen, indem du die Liste der Bereiche (Berechtigungen), die deine App benötigt, durch deine Konfigurations-ID und den erforderlichen OAuth-Gewährungstyp des Zugriffsschlüssels ersetzt.

Wenn du unsere SDKs noch nicht kennst, empfehlen wir dir, zuerst das JavaScript-SDK zu installieren und es mit dem Facebook Login-Produkt für Verbraucher*innen zum Laufen zu bringen, bevor du fortfährst, da die folgenden Beispiele auf das SDK verweisen.

Konfigurationen für Business-Integration-Systemnutzer-Zugriffsschlüssel

Hier ein Beispiel für die Methode FB.login() des JavaScript-SDK, die so geändert wurde, dass sie eine Konfiguration für einen Systemnutzer-Zugriffsschlüssel verwendet. Beachte, dass scope (sollte nicht verwendet werden) durch config_id ersetzt wurde und dass der response_typeauf code festgelegt wurde, da SUATs den Gewährungstyp „Autorisierungscode“ erfordern, und dass override_default_response_type auf true festgelegt werden muss. Sollte dies zutreffen, haben sämtliche von response_type übergebenen Antworttypen Vorrang vor den Standardtypen.

FB.login(
  function(response) [
    console.log(response);
  ],
  [
    config_id: '<CONFIG_ID>',
    response_type: 'code',
    override_default_response_type: true
  ]
);

Wenn der*die Nutzer*in den Login-Dialog-Ablauf abschließt, leiten wir den*die Nutzer*in zu deiner Weiterleitungs-URL weiter und schließen einen Code ein. Du musst diesen Code dann gegen einen Zugriffsschlüssel austauschen, indem du einen Server-zu-Server-Aufruf bei unseren Servern durchführst.

GET https://graph.facebook.com/v19.0/oauth/access_token?
  client_id=<APP_ID>
  &client_secret=<APP_SECRET>
  &code=<CODE>

Weitere Informationen zu diesem Schritt findest du unter Austausch von Code durch einen Zugriffsschlüssel.

Konfigurationen für Nutzer-Zugriffsschlüssel

Hier ein Beispiel für die Methode FB.login() des JavaScript-SDK, die so geändert wurde, dass sie eine Konfiguration für einen Nutzer-Zugriffsschlüssel verwendet. Beachte, dass scope durch config_id ersetzt wurde (auch wenn scope weiterhin eingeschlossen werden kann, raten wir von der Verwendung des Parameters ab).

FB.login(
  function(response) {
    console.log(response);
  },
  {
    config_id: '<CONFIG_ID>' // configuration ID goes here
  }
);

Hier ein Beispiel für den login-Button des JavaScript-SDK, der so geändert wurde, dass er eine Konfiguration für einen Nutzer-Zugriffsschlüssel verwendet:

<fb:login-button config_id="<CONFIG_ID>" onlogin="checkLoginState();"></fb:login-button>

Manuelles Aufrufen

Unter Manuelles Erstellen des Login-Ablaufs erfährst du, wie du den Login-Dialog manuell aufrufen kannst. Schließe beim Aufrufen des Login-Dialogs und Festlegen der Weiterleitungs-URL deine Konfigurations-ID als einen optionalen Parameter ein (auch wenn „scope“ weiterhin eingeschlossen werden kann, raten wir von der Verwendung dieses Parameters ab).

config_id=<CONFIG_ID>

Aktivieren von Facebook Login for Business

Facebook Login for Business ist für alle neu erstellten Business-Apps verfügbar. Bestehende berechtigteApps vom Typ Business und Apps vom Typ Keine wurden entweder automatisch umgestellt oder können für Facebook Login for Business aktiviert werden.

Wenn deine App berechtigt ist, zum Facebook Login for Business zu wechseln, sollte dir in den folgenden Schritten ein Aktivierungsbanner angezeigt werden:

1. Rufe das App-Dashboard deiner App auf.
2. Rufe das Facebook Login-Produkt auf oder füge es hinzu.
3. Klicke auf den Tab „Einstellungen“ oder den Tab „Kurzanleitung“.

Um zu Facebook Login for Business zu wechseln, musst du auf den Button „Aktivieren“ im Banner klicken. Mit dieser App verknüpfte Test-Apps führen die Aktivierung ebenfalls automatisch durch.

Nach dem Wechsel hat deine App den Typ Business. Für den Fall, dass deine App nicht wie vorgesehen funktioniert, darf für jede App innerhalb von 30 Tagen nach dem Wechsel zu Facebook Login ein Rollback durchgeführt werden. Dies ist höchstens 3 Mal möglich. Beachte Folgendes: Wenn der Login-Dialog für Facebook Login for Business via Konfigurations-ID aufgerufen wird und du entscheidest, zu Facebook Login zurückzuwechseln, kann das Laden des Login-Dialogs fehlschlagen. Das liegt daran, dass Facebook Login den Parameter ‚config_id‘ nicht unterstützt. Du musst diesen durch den Parameter ‚scope‘ ersetzen.

Problembehebung

Bei App-Installern kann es aus folgenden Gründen zu Fehlermeldungen kommen:

• Konfig-ID ist ungültig.
• Systemnutzer-Zugriffsschlüssel wird zurzeit nicht auf Mobilgeräten unterstützt.
• Systemnutzer-Zugriffsschlüssel ist mit falschem response_type eingerichtet.

Potenzielle funktionsgefährdende Änderungen:

• Wenn deine App zurzeit den Typ „Keine“ aufweist, führt der Wechsel zu Facebook Login for Business dazu, dass sich der App-Typ in „Business“ ändert. Die App kann dann nur auf Berechtigungen, Features und Produkte zugreifen, die mit diesem Login-Produkt verfügbar sind.
• Wenn deine vorhandenen App-Installer nur Zugriff auf die Berechtigungen „email“ oder „public_profile“ haben, führt der Wechsel der App zu Facebook Login for Business dazu, dass alle diese vorher installierten Zugriffsschlüssel ungültig werden.
• Wenn deine vorhandenen App-Installer Zugriff auf Berechtigungen/Features haben, die von Facebook Login for Business nicht unterstützt werden, werden diese Berechtigungen/Features nach dem Wechsel der App zu Facebook Login for Business sofort widerrufen.
• Wenn deine App sowohl über Facebook Login for Business als auch dieMeta Business Extension verfügt, ist die Nutzung von Meta Business Extension ausschließlich auf Berechtigungen beschränkt, die von Facebook Login for Business unterstützt werden.

Wechseln zu Facebook Login

Wenn deine App nach dem Wechsel zu Facebook Login for Business nicht wie vorgesehen funktioniert, kannst du sie deinstallieren, indem du zurück zu Facebook Login wechselst, dann zu App-Dashboard > Facebook Login for Business > Einstellungen navigierst und auf den Link Wechseln zu Facebook Login klickst. Dir wird eine Umfrage angezeigt, die uns hilft, das Facebook Login for Business-Konfigurationserlebnis zu verbessern. Jede App darf innerhalb von 30 Tagen nach dem Wechsel zu Facebook Login zurückkehren. Dies ist nur höchstens 3 Mal möglich.

FAQs

Wieso ist meine App nicht für Facebook Login for Business berechtigt?

Facebook Login for Business unterstützt nur bestimmte Berechtigungen und Funktionen. Eine App ist nicht berechtigt, wenn sie Berechtigungen oder Funktionen anfordert, die von Facebook Login for Business nicht unterstützt werden. Beachte, dass die email- und public_profile-Berechtigung gemeinsam mit mindestens einer anderen unterstützten Berechtigung angefordert werden muss.

Welche Schritte kann ich unternehmen, um eine App für die Teilnahme berechtigt zu machen?

Wenn deine App nicht zur Teilnahme berechtigt ist, kannst du eine neue App vom Typ „Business“ erstellen, für die Facebook Login for Business standardmäßig verfügbar ist, und unterstützte Unternehmensberechtigungen über die App-Review anfordern.

Welche Berechtigungen muss ich bei der Implementierung von Facebook Login for Business anfordern?

Fordere nur die minimal erforderlichen Berechtigungen an, die für die Funktionalität deiner App benötigt sind. Sei gegenüber den Nutzer*innen transparent darüber, warum du die einzelnen Berechtigungen und Funktionen benötigst. Beachte, dass die Berechtigungen email und public_profile für jede App-Installation zusammen mit mindestens einer anderen unterstützten Berechtigung angefordert werden müssen. Du kannst eine Konfiguration erstellen, um unterstützte Berechtigungen anzuzeigen und deine Berechtigungsanfragen für ein individuelleres Onboarding zu bündeln.