In diesem Abschnitt wird beschrieben, wie der Auszug einer Identität im Nachrichtenfluss konfiguriert wird.
Bevor Sie beginnen, müssen Sie die unten stehenden Tasks ausgeführt haben.
Bevor Sie einen Nachrichtenfluss so konfigurieren können, dass ein Identitätsauszug durchgeführt wird, müssen Sie überprüfen, ob ein geeignetes Sicherheitsprofil existiert, oder ein neues Sicherheitsprofil erstellen.
Weitere
Informationen finden Sie im Abschnitt Sicherheitsprofil erstellen.
Empfangsknoten können Identitäten aus dem Bitstrom abrufen.
- Ein MQ-Empfangsknoten ruft die Benutzer-ID (UserIdentifier) aus dem Nachrichtendeskriptor (MQMD) ab und legt sie im Element 'Identity Source Token' des Ordners 'Eigenschaften' ab. Gleichzeitig setzt er das Element 'Identity Source Type' auf Benutzername und das Element
'Identity Source Issued By' auf MQMD.Put-Anwendungsname.
- Ein HTTP-Empfangsknoten ruft den BasicAuth-Header aus der HTTP-Anforderung ab und entschlüsselt diesen. Anschließend werden die Daten in die Elemente für das Identitätsquellentoken und das Kennwort im Eigenschaftenordner eingefügt. Gleichzeitig setzt er das Element 'Identity Source Type' auf usernameAndPassword und das Element
'Identity Source Issued By' auf die HTTP-Headereigenschaft UserAgent.
- Ein SOAP-Empfangsknoten ruft entweder die entsprechenden Token, die durch die Richtliniensätze der WS-Sicherheit und Bindungen definiert sind, oder (falls diese nicht festgelegt sind) die zu Grunde liegende Definition des Transport-Headers ab und füllt anschließend die Felder für die Identitätsquelle im Eigenschaftenordner.
In einigen Fällen werden die aus den Transportheadern extrahierten Informationen nicht festgelegt, oder sie reichen reichen nicht für eine Authentifizierung oder Autorisierung aus.
Für eine Authentifizierung ist beispielsweise ein Token des Typs 'Benutzername + Kennwort' erforderlich, aber da bei WebSphere MQ nur ein Benutzername verfügbar ist, muss die eingehende Identität als vertrauenswürdig eingestuft werden. Sie können die Sicherheit jedoch erhöhen, indem Sie mit Hilfe von WebSphere MQ Extended Security Edition eine Sicherheit auf Transportprotokollebene anwenden.
Wenn der Transportheader die erforderlichen Identitätsberechtigungsnachweise nicht bereitstellen kann, müssen die Informationen als Teil des Hauptteils der ankommenden Nachricht bereitgestellt werden.
Damit dies möglich
ist, muss der Nachrichtenflussentwickler einen Pfad zu den relevanten Stellen in der Nachricht enthalten, damit die
Sicherheitsinformationen gefunden werden. Diese Informationen werden auf der Registerkarte Sicherheit für die HTTP- oder MQ-Empfangsknoten angegeben:
- Geben Sie als Identitätstokentyp den Typ des Identitätstokens an, das
in der Nachricht enthalten ist. Als Typ kann einer der folgenden Werte angegeben werden:
- Transportstandard
- Benutzername
- Benutzername + Kennwort
- X.509-Zertifikat
Der Standardwert ist Transportstandard.
- Geben Sie als Position des Identitätstokens die Position in der
Nachricht an, an der die Identität angegeben ist. Diese Angabe erfolgt in Form eines ESQL-Pfads oder XPath-Ausdrucks und muss sich in ein Token mit dem Typ Benutzername, Benutzername + Kennwort oder X.509-Zertifikat auflösen lassen.
Wenn Sie diese Option leer lassen, wird die Identität aus den Transportheaderorten abgerufen. Bei MQ wird die Identität beispielsweise aus dem Transportheader 'MQMD.UserIdentifier' abgerufen.
- Geben Sie als Position des Identitätskennworts die Position des
Kennworts innerhalb der Nachricht an. Diese Angabe erfolgt in Form eines ESQL-Pfades oder XPath-Ausdrucks und muss sich in eine
Zeichenfolge mit einem Kennwort auflösen lassen. Diese Option kann nur festgelegt werden, wenn Identitätstokentyp auf Benutzername + Kennwort gesetzt ist.
Wenn Sie diese Option leer lassen, wird das Kennwort aus dem Transportheader übernommen, falls es bereitgestellt wird. Bei Websphere MQ ist diese Angabe beispielsweise nicht festgelegt.
- Geben Sie in Identität - IssuedBy-Position eine Zeichenfolge oder einen Pfadausdruck an, um zu zeigen, wo (in der Nachricht) Informationen über den Aussteller der Identität enthalten sind. Diese Angabe erfolgt in Form eines ESQL-Pfades, XPath-Ausdrucks oder Literals mit Informationen zur Herkunft der Identität.
Wenn Sie diese Option leer lassen, wird der Transportheaderwert verwendet (falls vorhanden).
Bei MQ wird beispielsweise der Wert 'MQMD.PutApplName' verwendet.
- Optional: Geben Sie die Eigenschaften an den Nachrichtenfluss weiter. Auf diese Weise wird sichergestellt, dass alle Empfangsknoten dieselben Informationen
verwenden.
Um den Auszug einer Identität im Nachrichtenfluss zu aktivieren, müssen Sie außerdem ein Sicherheitsprofil auswählen:
- Wechseln Sie in die Perspektive 'Brokeranwendungsentwicklung'.
- Klicken Sie in der Brokerentwicklungssicht mit der rechten Maustaste auf die Brokerarchivdatei, und klicken Sie dann auf Öffnen mit > Brokerarchiveditor.
- Klicken Sie auf die Registerkarte Konfigurieren.
- Klicken Sie auf den Fluss oder Knoten, in dem Sie das Sicherheitsprofil festlegen möchten.
- Wählen Sie im Feld Name des Sicherheitsprofils ein Sicherheitsprofil aus.
- Speichern Sie die Brokerarchivdatei.