Richten Sie SuccessFactors-Spoke v4.xx ein

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 8 Minuten Lesedauer

    • Integrieren Sie die Instanz ServiceNow mithilfe der OAuth-Client-Anwendung und des API-Schlüssels in die Instanz SuccessFactors.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an.
    • Aktivieren Sie die SuccessFactors-Spoke.
    • Aktivieren Sie diese Systemeigenschaften:
      • glide.pf.rest.response_payload_max_size: Der Höchstwert ist 10240.
      • com.snc.process_flow.reporting.serialized.val_size_limit: Der Höchstwert ist 16384.
      • com.glide.transform.json.max-partial-length: Der Höchstwert ist 65536.
    • Erforderliche Rolle: admin.
    Hinweis:
    Dieses Verfahren gilt, wenn Sie SuccessFactors-Spoke in4.5.0 zum ersten Mal einrichten. Wenn Sie eine frühere Version von SuccessFactors-Spokeverwenden, finden Sie unter Migrieren Sie zu SuccessFactors-Spoke v4.5.0 Informationen zum Migrationsverfahren.

    Weitere Informationen zum Einrichten der Spoke finden Sie unter SAP SuccessFactors-Spoke – OAuth-Setup und -Migration – Pre-Tokyo, Tokyo und darüber hinaus in ServiceNow Community.

    Registrieren Sie die OAuth-Client-Anwendung in SuccessFactors

    Aktivieren Sie die Client-Zertifikatauthentifizierung für die ausgehende Kommunikation von SAP Stammdatenservice , indem Sie die Dateien „keystore.jks“ und „ keystore.cer generieren.

    Vorbereitungen

    Prozedur

    1. Melden Sie sich beim Konto SuccessFactors als Administrator an.
    2. Navigieren Sie zu Admin Center und klicken Sie auf Unternehmenseinstellungen.
    3. Klicken Sie auf OAuth2-Client-Anwendungen verwalten.
    4. Klicken Sie auf Client-Anwendung registrieren.
      Registrieren Sie eine Client-Anwendung.
    5. Geben Sie die erforderlichen Details im Formular an.
      Geben Sie im Feld X.509-Zertifikat den Inhalt der Datei cert.pem (öffentlicher Schlüssel) ohne Header an.
    6. Klicken Sie auf Absenden.
      API-Schlüssel wird generiert und angezeigt. Kopieren Sie den Wert, und notieren Sie ihn zur späteren Verwendung.

    Laden Sie das JKS-Zertifikat in Ihre Instanz ServiceNow hoch

    Aktivieren Sie die Client-Zertifikatauthentifizierung für die ausgehende Kommunikation, indem Sie das JKS-Zertifikat in Ihre Instanz ServiceNow hochladen.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Melden Sie sich bei Ihrer Instanz ServiceNow als Administrator an.
    2. Laden Sie das JKS-Zertifikat in Ihre Instanz ServiceNow hoch.
      Anweisungen zum Hochladen des JKS-Zertifikats finden Sie unter Ein Zertifikat in eine Instanz hochladen .
      Laden Sie das JKS-Zertifikat hoch.

    Registrieren Sie SuccessFactors als OAuth-Anbieter

    Verwenden Sie den API-Schlüssel, der während der Konfiguration der Clientanwendung generiert wurde, um die Anwendung als OAuth-Anbieter zu registrieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren Sie in Ihrer Instanz von ServiceNow zu System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
    3. Füllen Sie diese Felder im Formular aus.
      Feld Beschreibung
      Name Eindeutiger Name zur Identifizierung des Zertifikats. Beispiel: SuccessFactors SAML.
      Client-ID Wert des API-Schlüssels, den Sie nach der Registrierung der OAuth-Client-Anwendung in SuccessFactorskopiert haben.
      Geheimer Clientschlüssel
      Hinweis:
      Zur Registrierung der Anwendung als OAuth-Anbieter ist kein Clientgeheimnis erforderlich. Sie können einen beliebigen Wert für dieses Feld angeben.
      Standardgewährungstyp Standardgewährungstyp, der zum Erstellen des Tokens verwendet wird. Wählen Sie SAML2-Beareraus.
      Token-URL SuccessFactors OAuth-Server-Endpunkt-URL, die die Unternehmens-ID in diesem Format enthält: https://<SuccessFactors_Instance_Name> /oauth/token?company_id=<Company_ID> . Beispiel: https://example.successfactors.eu/oauth/token?company_id=SFCPART123456.
      Anwendungsregistrierungsdatensatz.
    4. Klicken Sie auf Absenden.

    Erstellen Sie den SAML2-Assertionsersteller-Datensatz

    Erstellen Sie einen SAML2-Assertionsdatensatz, um die SAML2-Assertion zu generieren, und tauschen Sie die Assertion für die Zugriffstoken mit dem Anbieter aus.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Erstellen Sie einen SAML2-Assertionsersteller-Datensatz in Ihrer Instanz ServiceNow.
      1. Navigieren zu Alle > System-OAuth > SAML2-Assertionsersteller.
      2. Klicken Sie auf Neu.
      3. Füllen Sie diese Werte im Formular aus.
        Feld Beschreibung
        Name Eindeutiger Name zur Identifizierung des SAML2-Assertionsersteller-Datensatzes. Beispiel: Erfolgsfaktor SAML OAuth.
        Bearbeiter Eindeutiger Bezeichner für die Entität, die die Assertion ausgibt. Geben Sie die URL der -Instanz ServiceNow an.
        Antragsteller-NameID Anwendername für die Anmeldung bei der Instanz SuccessFactors. Beispiel: sfadmin.
        Zielgruppe Vorgesehene Zielgruppe für die Assertion. Geben Sie den Wert www.successfactors.comein.
        Empfänger Vorgesehener Empfänger für die Assertion. Geben Sie die URL in diesem Format ein: https://<SuccessFactors-Instance-Name> /oauth/token .
        SAML2-Assertionsersteller-Datensatz.
      4. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
      5. Klicken Sie unter der Registerkarte SAML2-Assertionsschlüsselspeicher auf Neu.
      6. Füllen Sie diese Werte im Formular aus.
        Feld Beschreibung
        Name Eindeutiger Name zur Identifizierung des SAML2-Assertionsschlüsselspeicher-Datensatzes. Beispiel: sap_successfactor.
        Signaturschlüsselalias Alias der im Schlüsselspeicher gespeicherten Schlüsseleingabe zum Signieren der Assertion. Beispiel: 1.
        Signaturschlüssel-Passwort Passwort des im Schlüsselspeicher gespeicherten Schlüsseleintrags, der zum Signieren der Assertion verwendet wird.
        Signatur-Schlüsselspeicher Erforderlicher X.509-Zertifikatdatensatz. Wählen Sie den X.509-Zertifikatdatensatz aus, den Sie zuvor erstellt haben. Weitere Informationen finden Sie unter Laden Sie das JKS-Zertifikat in Ihre Instanz ServiceNow hoch.
        SAML2-Assertionsschlüsselspeicher-Datensatz.
      7. Klicken Sie auf Absenden.
      8. Navigieren zu Alle > System-OAuth > SAML2-Assertionsersteller.
      9. Öffnen Sie den von Ihnen erstellten SAML2-Assertionsersteller-Datensatz.
        Beispiel: Erfolgsfaktor SAML OAuth.
      10. Klicken Sie auf der Registerkarte SAML2-Assertionsattribute auf Neu.
      11. Füllen Sie diese Werte im Formular aus.
        Feld Beschreibung
        Name Name zur Identifizierung des SAML2-Assertionsattributdatensatzes. Geben Sie api_key ein.
        Typ Typ des Felds „Wert “ Wählen Sie Zeichenfolge aus.
        Wert API-Schlüssel, der nach der Erstellung der OAuth-Client-Anwendung in SuccessFactorsgeneriert wird.
        SAML2-Assertionsattribut-Datensatz.
      12. Klicken Sie auf Absenden.
    2. Ordnen Sie den SAML2-Assertionsersteller dem Anwendungsregistrierungsdatensatz zu.
      1. Navigieren zu System-OAuth > Applikationsregistrierung.
      2. Öffnen Sie den von Ihnen erstellten Anwendungsregistrierungsdatensatz.
        Beispiel: SuccessFactors OAuth Reg. Weitere Informationen zum Erstellen der Anwendungsregistrierung finden Sie unter Registrieren Sie SuccessFactors als OAuth-Anbieter.
      3. Öffnen Sie auf der Registerkarte OAuth-Entitätsprofile den Standard-OAuth-Entitätsprofil-Datensatz.
        Beispiel: Erfolgsfaktor SAML default_profile.
      4. Wählen Sie im Feld Assertionsersteller den von Ihnen erstellten SAML2-Assertionsersteller-Datensatz aus.
        Beispiel: Erfolgsfaktor SAML OAuth.
        OAuth-Entitätsprofil-Datensatz.
      5. Klicken Sie auf Aktualisieren.

    Erstellen Sie einen Anmeldeinformationsdatensatz für die OData-API

    Erstellen Sie einen Anmeldeinformationsdatensatz für die OData-APIs in SuccessFactors. Der Alias für Verbindungen und Anmeldeinformationen SuccessFactors-Spoke verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen mithilfe der OData-API.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationen.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
      Ein leeres Formular mit Anmeldeinformationen für OAuth 2.0 wird angezeigt.
    4. Füllen Sie diese Werte im Formular aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise SAML_SuccessFactors_OData_Credein.
      OAuth-Einheitenprofil OAuth-Entitätsprofil-Datensatz, der der von Ihnen erstellten OAuth-Anwendungsregistrierung zugeordnet ist. Beispiel: Erfolgsfaktor SAML default_profile.

      Weitere Informationen zum Erstellen der Anwendungsregistrierung finden Sie unter Registrieren Sie SuccessFactors als OAuth-Anbieter.
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      Reihenfolge Reihenfolge zum Anwenden dieser Anmeldeinformationen. Geben Sie z. B. 100 ein.
      OData-Anmeldeinformationsdatensatz.
    5. Klicken Sie auf Absenden.

    Ergebnisse

    Der Anmeldeinformationsdatensatz zum Autorisieren von Aktionen mit der OData-API wird erstellt.

    Erstellen Sie einen Anmeldeinformationsdatensatz für die SOAP-API

    Erstellen Sie einen Anmeldeinformationsdatensatz für die SOAP-APIs in SuccessFactors. Der Alias für Verbindungen und Anmeldeinformationen SuccessFactors-Spoke verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen, die die SOAP-APIs verwenden.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationen.
    2. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an..
    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
      Ein leeres Formular mit Anmeldeinformationen für OAuth 2.0 wird angezeigt.
    4. Füllen Sie diese Werte im Formular aus.
      Feld Wert erforderlich
      Name Name zur eindeutigen Identifizierung des Datensatzes. Geben Sie beispielsweise SAML_SuccessFactors_SOAP_Credein.
      OAuth-Einheitenprofil OAuth-Entitätsprofil-Datensatz, der der von Ihnen erstellten OAuth-Anwendungsregistrierung zugeordnet ist. Beispiel: Erfolgsfaktor SAML default_profile.

      Weitere Informationen zum Erstellen der Anwendungsregistrierung finden Sie unter Registrieren Sie SuccessFactors als OAuth-Anbieter.
      Aktiv Option zur aktiven Verwendung des Anmeldeinformationsdatensatzes.
      Reihenfolge Reihenfolge zum Anwenden dieser Anmeldeinformationen. Geben Sie z. B. 100 ein.
      SOAP-Anmeldeinformationsdatensatz.
    5. Klicken Sie auf Absenden.

    Ergebnisse

    Der Anmeldeinformationsdatensatz zum Autorisieren von Aktionen mit der SOAP-API wird erstellt.

    Erstellen Sie einen Verbindungsdatensatz für die OData-API

    Erstellen Sie einen Verbindungsdatensatz für die OData-API in SuccessFactors. Der Alias für Verbindungen und Anmeldeinformationen SuccessFactors-Spoke verwendet diese Verbindungen, um Aktionen in SuccessFactorsauszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie für den Datensatz für SuccessFactors OData.
      Beispiel: SuccessFactors_OData.
    3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 1. Formular „HTTP(s)-Verbindung“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: SAML_SuccessFactors_OData_Conn.
      Referenz Anmeldeinformationsdatensatz, den Sie für die REST API erstellt haben. Beispiel: SAML_SuccessFactors_OData_Cred.
      Verbindungs-URL SuccessFactors Servicestamm-URL in diesem Format: https://<SuccessFactors_Instance_Name> /odata/v2 . Beispiel: https://example.successfactors.eu/odata/v2.
      Hinweis:
      Wenn Sie einen SAP-Cloud-Account verwenden, wählen Sie unter Liste der SAP SuccessFactors-API-Server im SAP-Hilfeportal den richtigen Endpunkt aus, der für den API-Server als Ziel erforderlich ist.
      Aktiv Option zur aktiven Verwendung des Verbindungsdatensatzes.
      OData-Verbindungsdatensatz.
    5. Klicken Sie auf Absenden.

    Ergebnisse

    Der Verbindungsdatensatz für die REST-API in SuccessFactors wird erstellt.

    Erstellen Sie einen Verbindungsdatensatz für die SOAP-API

    Erstellen Sie einen Verbindungsdatensatz für die SOAP-API in SuccessFactors. Der Alias für Verbindungen und Anmeldeinformationen SuccessFactors-Spoke verwendet diese Verbindungen, um Aktionen in SuccessFactorsauszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie für den Datensatz für die SuccessFactors-SOAP-API.
      Beispiel: SuccessFactors_Comp_Emp.
    3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 2. Formular „HTTP(s)-Verbindung“
      Feld Beschreibung
      Name Name zur eindeutigen Identifizierung des Datensatzes. Beispiel: SAML_SuccessFactors_SOAP_Conn.
      Referenz Anmeldeinformationsdatensatz, den Sie für die SOAP-API erstellt haben. Beispiel: SAML_SuccessFactors_SOAP_Cred.
      Verbindungs-URL SuccessFactors Verbindungs-URL. Beispiel: https://<SuccessFactors_Instance_Name> /sfapi/v1/soap . Beispiel: https://example.successfactors.eu/sfapi/v1/soap.
      Hinweis:
      Wenn Sie einen SAP-Cloud-Account verwenden, wählen Sie unter Liste der SAP SuccessFactors-API-Server im SAP-Hilfeportal den richtigen Endpunkt aus, der für den API-Server als Ziel erforderlich ist.
      Aktiv Option zur aktiven Verwendung des Verbindungsdatensatzes.
    5. Geben Sie auf der Registerkarte Attribute diese Felder an.
      Feld Beschreibung
      Unternehmens-ID Unveränderliche Unternehmens-ID Ihrer Instanz von SuccessFactors.
      Flow-Zeitüberschreitung (Sekunden) Maximale Zeit in Sekunden, bis zu der während der Flow-Ausführung Daten von SuccessFactors empfangen werden können. Wenn die zum Abrufen von Daten aus SuccessFactors benötigte Zeit die Zeitüberschreitungsdauer überschreitet, wird der Flow oder Subflow abgebrochen. Der Standardwert ist 30.
      SOAP-Verbindungsdatensatz.
    6. Klicken Sie auf Absenden.

    Ergebnisse

    Der Verbindungsdatensatz für die SOAP-API in SuccessFactors wird erstellt.

    Daten zwischen SuccessFactors und ServiceNowsynchronisieren

    Passen Sie die Beispiel-Flows an Ihre Anforderungen an, um Daten zwischen Ihren Instanzen SuccessFactors und ServiceNow zu synchronisieren.

    Entität „Aufgaben“.

    Die SuccessFactors -Spoke bietet Beispiel-Flows zum bidirektionalen Synchronisieren von Daten für die Entität „todo“. Der Beispiel-Flow „SuccessFactors-Integrations-Flow ausführen“ kann so angepasst werden, dass Daten aus SuccessFactorsabgerufen werden, während die Flows „Aufgabe erstellen“ und „Aufgabe aktualisieren“ die Aufgabendatensätze in SuccessFactors erstellen oder aktualisieren, wenn Ereignisse in ServiceNowauftreten. Stellen Sie beim Anpassen der Beispiel-Flows sicher, dass Sie geeignete Auslöser zum Abrufen und Speichern zukünftiger Updates mithilfe von Transformationszuordnungen angeben.

    Andere Standardentitäten

    Für diese Entitäten kann der Beispiel-Flow „SuccessFactors-Integrations-Flow ausführen“ angepasst werden, um Daten von SuccessFactorsabzurufen:
    • Abteilung
    • Standort
    • Stellenprofil
    • Mitarbeiterprofil
    • Effektives Mitarbeiterprofil
    • Aufgabenverlauf einschließlich sekundärer Zuweisungen

    So erstellen oder aktualisieren Sie Datensätze in SuccessFactors für diese Entitäten, wenn Ereignisse in ServiceNowauftreten:

    • Erstellen Sie Flows oder Subflows nach Ihrer Wahl, oder passen Sie die Beispiel-Flows und Subflows an.
    • Verwenden Sie Aktionen zum Abrufen von Metadaten und zur Verwaltung von Datensätzen in Ihren Flows.
    • Stellen Sie sicher, dass Sie geeignete Auslöser angeben, um zukünftige Updates mithilfe von Transformationszuordnungen abzurufen und zu speichern.

    Andere SuccessFactors -Entitäten

    Abhängig von den Berechtigungen und Konfigurationen SuccessFactors für können Sie auch Daten anderer Entitäten gemäß Ihren Anforderungen synchronisieren.