Zuweisung der Identifier-First-Authentifizierung (IFA) zu Themen

Online bearbeiten

Sobald Ihr IFA-Ablauf (Identifier-First Authentication) im Ablauf-Designer veröffentlicht wurde, müssen Sie die gewünschten Designs aktualisieren, um die Anmeldeoberfläche entsprechend anzupassen.

Vorbereitende Schritte

  • Zur Ausführung dieser Task müssen Sie über Verwaltungsberechtigung verfügen.
  • Melden Sie sich bei der IBM® Verify Verwaltungskonsole an.
  • Sie müssen über einen veröffentlichten IFA-Ablauf verfügen. Weitere Informationen finden Sie unter „Konfigurieren der Identifier-First-Authentication (IFA) “.

Informationen zu dieser Task

Passen Sie die gewünschten Designs an, um das Anmeldeerlebnis individuell zu gestalten, indem Sie die folgende HTML-Seite aktualisieren: template/authentication/login/identity sources/identity source selection/combined_login_selection.html.

Die Verify-Branding-Funktion unterstützt die Bearbeitung von HTML-Dateien des Themes und ermöglicht Inline- JavaScript,, sodass Sie ein Skript einfügen können, das Ihren IFA-Ablauf direkt von der Anmeldeseite aus startet. theme.zipThemenpakete werden aktualisiert, indem man die Datei herunterlädt, ihre Dateien bearbeitet und die .zip Datei über die Branding-API erneut hochlädt.

Vorgehensweise

  1. Laden Sie Ihr aktuelles Design herunter.

    Themes können entweder über die Verify-Benutzeroberfläche oder über die Branding-API aktualisiert werden.

    Verify-Benutzeroberfläche verwenden
    Wenn Sie bereits über ein Theme verfügen, das das IFA-Weiterleitungsskript enthält (entweder über die API aktualisiert oder von Ihrem Entwicklerteam erstellt), können Sie es Ihren Anwendungen direkt in der Benutzeroberfläche zuweisen.
    1. Navigieren Sie zu „Benutzererfahrung “ > „Branding “.
    2. Klicken Sie auf „Benutzerdefiniertes Design erstellen “.
    3. Klicken Sie auf „Master-Vorlagendateien herunterladen “ und entpacken Sie die .zip Datei anschließend lokal.
      Diese Dateien enthalten die Anmeldevorlagen, die Sie anpassen werden.
    4. Fügen Sie den „ JavaScript “ hinzu, der Ihren IFA-Ablauf startet.
      Fügen Sie in der entsprechenden Anmeldevorlage Folgendes hinzu:
      <script>  window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start"; </script>
      .
    5. Packen Sie die angepassten Vorlagendateien erneut in eine ZIP-Datei.
      Hinweis: Behalte die Ordnerstruktur bei und packe das Stammverzeichnis in eine ZIP-Datei.
    6. Klicken Sie im Fenster auf „Datei hochladen “ und wählen Sie Ihre .zip Datei aus.
    7. Geben Sie einen Namen für das Design ein und klicken Sie auf „Design erstellen “.
    Verwenden Sie die Branding-API
    1. Das Themenpaket anfordern:
      GET https://<tenant>/v1.0/branding/themes/<themeID>
      . Fügen Sie ein gültiges Zugriffstoken bei. Das Theme wird als Datei heruntergeladen, die .zip alle Theme-Vorlagen enthält.
    2. Entpacken Sie die .zip Datei lokal, um die Vorlagen anzuzeigen und zu bearbeiten.
  2. Suchen Sie im entpackten Ordner die Vorlage für die Anmeldeseite.
    Die Pfadnamen variieren je nach Theme, aber die Anmeldevorlage befindet sich in der Regel unter:
    /templates/authentication/login/cloud_directory/default/login.html
/templates/authentication/login/saml/default/login.html
/templates/authentication/login/oidc/default/login.html

    Passen Sie die Anmeldevorlage so an, dass Benutzer zu Ihrem veröffentlichten IFA-Ablauf weitergeleitet werden (unter Verwendung des Triggers „ URL “ aus dem Abschnitt „Konfigurieren der Identifier-First-Authentifizierung“ ).

  3. Fügen Sie in der login.html Datei einen Inline-Link <script> ein, der die Benutzer zu Ihrem veröffentlichten IFA-Ablauf unter URL weiterleitet.
    Beispiel:
    <script>
  window.location.href = "https://<tenant>/v1.0/flows/<flowID>/start";
</script>
  4. Entpacken Sie den Theme-Ordner wieder in seiner ursprünglichen Struktur.
  5. Laden Sie das aktualisierte Theme über die Branding-API hoch:
    curl -X PUT 'https://<tenant>/v1.0/branding/themes/<themeID>' \
  --header 'Content-Type: multipart/form-data' \
  -F 'configuration=@themeConfiguration.json' \
  -F 'files=@updatedTheme.zip' \
  -H 'Authorization: Bearer <access_token>'
  6. Wenn das Theme hochgeladen wird:
    1. Navigieren Sie im Verwaltungs-Tenant zu „Anwendungen “ > „Anwendungen “.
    2. Öffnen Sie die Anwendung, die den IFA-Ablauf nutzen soll.
    3. Gehen Sie in den Einstellungen der Anwendung zum Feld „Design “.
    4. Wählen Sie das aktualisierte Design aus.
  7. Prüfen Sie, ob Ihr Theme in Ihren IFA-Ablauf weiterleitet.
    Falls dies nicht der Fall ist, überprüfen Sie die Platzierung des Skripts noch einmal und stellen Sie sicher, dass die richtige Ablaufauslöser- URL en hinzugefügt wurden.

Ergebnisse

Sie haben die Zuordnung des IFA-Ablaufs (Identifier-First Authentication) zu den Themen abgeschlossen.

Nächste Schritte

Konfigurieren Sie den Einladungsablauf. Siehe: Einrichten eines Einladungs-Workflows.