Zum Inhalt springen

Importieren und Exportieren eines Sicherheitsanbieters im Jitterbit App Builder

Der App Builder unterstützt sowohl das Importieren als auch das Exportieren von Konfigurationen für Sicherheitsanbieter.

Importieren

Um einen Sicherheitsanbieter zu importieren, melden Sie sich zunächst als Administrator im App Builder an:

  1. Wechseln Sie zum IDE
  2. Klicken Sie auf die Schaltfläche Sicherheitsanbieter
  3. Erweitern Sie im Konfigurations-Panel das Menü Mehr und klicken Sie auf Anbieter importieren
  4. Geben Sie den serialisierten Sicherheitsanbieter an. Siehe Format unten.
  5. Klicken Sie auf die Schaltfläche Importieren
  6. Klicken Sie auf die Schaltfläche Anzeigen, um den Sicherheitsanbieter anzuzeigen und zu ändern

Der App Builder weist dem Sicherheitsanbieter beim Import eine eindeutige Kennung zu.

Der neue Sicherheitsanbieter wird standardmäßig deaktiviert und erscheint nicht im Anmeldeformular.

Exportieren

Um einen Sicherheitsanbieter zu exportieren, melden Sie sich zunächst als Administrator im App Builder an:

  1. Wechseln Sie zum IDE
  2. Klicken Sie auf die Schaltfläche Sicherheitsanbieter
  3. Suchen Sie den Sicherheitsanbieter und klicken Sie auf das Details-Symbol (Chevron)
  4. Erweitern Sie das Menü Mehr und klicken Sie auf Anbieter exportieren

Dies zeigt die serialisierte Konfiguration des Sicherheitsanbieters an.

Format

Das Format der Sicherheitsanbieter-Konfiguration hat die Form eines JSON-Dokuments.

Das Wurzelelement ist ein Objekt vom Typ Provider.

Beispiel

{
  "name": "MyIdP",
  "type": "saml_sp",
  "audience": "https://example/Vinyl",
  "recipient": "https://example/Vinyl/signin-MyIdP",
  "settings": {},
  "groups": [],
  "claimTypes": [],
  "endpoints": [
    {
      "type": "metadata",
      "url": "https://example/saml/metadata"
    }
  ],
  "credentials": [],
  "certificates": []
}

Typen

Anbieter

Name Typ Beschreibung
name String Name des Sicherheitsanbieters.
type ProviderType Typ des Sicherheitsanbieters.
authenticationType AuthenticationType Authentifizierungstyp.
oauthGrantType OAuthGrantType OAuth-Zugriffsart.
oauthClientAuthenticationType OAuthClientAuthenticationType OAuth-Client-Authentifizierungstyp.
oauthResourceAuthenticationType OAuthResourceAuthenticationType OAuth-Ressourcen-Authentifizierungstypen.
tokenOwner TokenOwner Tokenbesitzer.
subject String Token-Subjekt.
issuer String Token-Issuer.
audience String Token-Zielgruppe.
recipient String Token-Empfänger.
entityId String Token-Entitätskennung.
identityProviderUrl String URL des Identitätsanbieters (IdP).
endpoints Endpoint[] Array von Endpunkten.
credentials Credential[] Array von Anmeldeinformationen.
certificates Certificate[] Array von Zertifikaten und Schlüsseln.
settings Object Sammlung von Schlüssel/Wert-Paaren, wobei jeder Schlüssel einem bekannten Parameternamen entspricht. Siehe die spezifische Dokumentation des Sicherheitsanbieters für eine Liste unterstützter Parameter.
claimTypes ClaimType[] Array von Anspruchstypen.
groups Group[] Array von Sicherheitsgruppen.
registration Registration Registrierung des Sicherheitsanbieters.

Endpoint

Name Type Beschreibung
type EndpointType Endpunkt-Typ.
url String Endpunkt-URL.

Credential

Name Type Beschreibung
type CredentialType Anmeldedaten-Typ.
userName String Benutzername.
password String Klartext-Passwort.

Certificate

Name Type Beschreibung
usage CertificateUsage Verwendung des Zertifikats.
type CertificateType Zertifikatstyp.
format CertificateFormat Zertifikatsformat.
content String Kodiertes Zertifikat oder Schlüssel.
password String Klartext-Passwort.
thumbprint String Zertifikat-Thumbprint.

ClaimType

Name Type Beschreibung
identitier String Identifikator des Anspruchstyps, typischerweise eine URL oder JSON-Schlüssel.
usage ClaimTypeUsage Verwendung des Anspruchstyps.
priority Number Priorität des Anspruchstyps.
ignore Boolean Gibt an, ob der Anspruchstyp ignoriert werden soll.

Group

Name Type Beschreibung
name String Gruppenname.
identifier String Gruppenidentifikator.
groupId Unique ID Identifikator der Sicherheitsgruppe im App Builder.
grantOnIdentityCreate Boolean Gibt an, ob Identitäten zur Gruppe hinzugefügt werden sollen, wenn sie bereitgestellt werden.

Registration

Name Type Beschreibung
enabled Boolean Aktiviert den Sicherheitsanbieter.
priority Number Ordinale Position des Sicherheitsanbieters.
sealed Boolean Versiegelt den Sicherheitsanbieter. NUR FÜR INTERNEN GEBRAUCH.
redirectOnChallenge Boolean Umgeht das Anmeldeformular und leitet den Client zum Benutzer-Authentifizierungsanbieter weiter, wenn eine Herausforderung besteht.
showOnLoginForm Boolean Zeigt den Benutzer-Authentifizierungsanbieter im Anmeldeformular an.
userProvisioning Boolean Aktiviert die Bereitstellung für den Benutzer-Authentifizierungsanbieter.
matchExistingUser Boolean Ermöglicht es dem Bereitstellungsprozess, Identitäten bestehenden Benutzern zuzuordnen.
suppliesGroupMembership Boolean Gibt an, dass der Benutzer-Authentifizierungsanbieter die Mitgliedschaft in Sicherheitsgruppen verwaltet.
storeClaims Boolean Gibt an, dass der App Builder alle Ansprüche speichern soll, die vom Benutzer-Authentifizierungsanbieter empfangen werden.
defaultAuthenticationProvider Boolean Gibt an, dass der App Builder den Benutzer-Authentifizierungsanbieter zum Standardbenutzer-Authentifizierungsanbieter des Systems machen soll.

Werte

AnbieterTyp

Wert Beschreibung
active_directory Active Directory
adobe_pdf_services Adobe PDF Services
api_key API-Schlüssel
app_auth Anwendungsauthentifizierung
google_openid_connect Google-Konten / OpenID Connect
http_basic_auth HTTP Basic-Authentifizierung
http_client HTTP-Client
iwa_ Integrierte Windows-Authentifizierung
jwt_sso JWT SSO
local Lokaler Benutzer
microsoft_openid_connect Microsoft / OpenID Connect
oauth2 OAuth 2.0
openid_connect OpenID Connect 1.0
provisioning Benutzerbereitstellung
rewrite_url URL umschreiben
salesforce Salesforce
salesforce_openid_connect Salesforce / OpenID Connect
saml_idp SAML-Identitätsanbieter (IdP)
saml_sp SAML-Dienstanbieter (SP)
sap_odata_services SAP OData-Dienste
successfactors_odata SuccessFactors OData
successfactors_password SuccessFactors-Passwort
wam Webzugriffsmanagement
ws_federation WS-Federation

Authentifizierungstyp

Wert Beschreibung
anonymous Anonym
basic Basis
delegated_oauth2 Delegiertes OAuth [VERALTET]
oauth2 OAuth

Die Unterstützung variiert je nach Sicherheitsanbieter.

OAuthGewährungstyp

Wert Beschreibung
authorization_code Autorisierungscode
client_credentials Client-Anmeldeinformationen
password Anmeldeinformationen des Ressourcenbesitzers
refresh_token Aktualisierungstoken
urn:ietf:params:oauth:grant-type:jwt-bearer JWT-Bearer-Token
urn:ietf:params:oauth:grant-type:saml2-bearer SAML 2.0 Bearer-Assertion

Die Unterstützung variiert je nach Sicherheitsanbieter.

OAuthClientAuthentifizierungstyp

Wert Beschreibung
none Keine
client_secret_basic Basis
client_secret_post Parameter

Die Unterstützung variiert je nach Sicherheitsanbieter.

OAuthRessourcenAuthentifizierungstyp

Wert Beschreibung
bearer Träger
form_post Formular
query Abfrage

Die Unterstützung variiert je nach Sicherheitsanbieter.

TokenOwner

Wert Beschreibung
client Client-System, d.h. App Builder
user Benutzer

EndpointType

Wert Beschreibung
acs Assertion Consumer Service
api API-Endpunkt
authorization Autorisierungsendpunkt
issuer OpenID Connect-Aussteller
metadata Metadatenendpunkt
relay_state RelayState-URI
request_redirect Anforderungsumleitungsendpunkt
sso Single Sign-On-Dienst
token Token-Endpunkt
user_info Benutzerinformationsendpunkt

Die Unterstützung variiert je nach Sicherheitsanbieter.

CredentialType

Wert Beschreibung
client OAuth-Client.
directory_reader Active Directory-Leser.
resource_owner OAuth-Ressourcenbesitzer.

Die Unterstützung variiert je nach Sicherheitsanbieter.

CertificateUsage

Wert Beschreibung
client Client-Zertifikat
signature_validation Signaturvalidierung
signing Signierung

Die Unterstützung variiert je nach Sicherheitsanbieter.

CertificateType

Wert Beschreibung
rsa_private_key RSA-Privatschlüssel
rsa_public_key Öffentlicher Schlüssel
x509 X.509-Zertifikat
x509_private_key X.509-Zertifikat mit privatem Schlüssel

Die Unterstützung variiert je nach Sicherheitsanbieter.

CertificateFormat

Wert Beschreibung
certificate_store Zertifikatspeicher
pem PEM
pkcs12 PKCS#12 (PFX)

Die Unterstützung variiert je nach Sicherheitsanbieter.

ClaimTypeUsage

Wert Beschreibung
displayName Anzeigename
emailAddress E-Mail-Adresse
fullName Vollständiger Name
group Sicherheitsgruppe
name Name
nameId Bezeichner
none Keine
phoneNumber Telefonnummer