Um ein Sicherheitsprofil zu erstellen, das sicherstellt, dass jede Nachricht eine
authentifizierte ID besitzt und für den Nachrichtenfluss autorisiert wird, müssen Sie den Befehl
mqsicreateconfigurableservice in der Befehlszeile
eingeben. Beispiel:
mqsicreateconfigurableservice WBRK_BROKER -c SecurityProfiles -o LDAP
-n authentication,authenticationConfig,authorization,authorizationConfig
-v "LDAP,\"ldap://ldap.acme.com:389/ou=sales,o=acme.com\",LDAP,
\"ldap://ldap.acme.com:389/cn=All Sales,ou=acmegroups,o=acme.com\""
Wie im Beispiel gezeigt, muss die LDAP-URL (die Kommas enthält) in Escapezeichen mit Anführungszeichen gesetzt werden \" und \" , damit die URL-Kommas nicht mit den Kommatrennzeichen des Werteparameters von mqsicreateconfigurableservice verwechselt werden.
Wenn die LDAP-URL einen Elementnamen mit einem Leerzeichen enthält, in diesem Fall cn=All Sales, muss die Gruppe von Werten nach dem Flag -v in Anführungszeichen (") stehen.
Weitere Informationen zur Befehlsstruktur finden Sie im Abschnitt mqsicreateconfigurableservice-Befehl.
Sie können die sicherheitsspezifischen Teile des Befehls wie folgt definieren:
- Setzen Sie 'authentication' auf LDAP. Dadurch wird sichergestellt, dass die ankommende Identität geprüft wird.
- Setzen Sie 'authorization' auf LDAP. Dadurch wird sichergestellt, dass die ankommende Identität auf Gruppenzugehörigkeit in LDAP überprüft wird.
- Legen Sie 'authenticationConfig' fest, und verwenden Sie dabei folgende Syntax:
ldap[s]://Server[:Port]/Basis-DN[?[Benutzer-ID-Attribut][?[base|sub]]]
Beispiel:
ldap://ldap.acme.com:389/ou=sales,o=acme.com
ldaps://localhost:636/ou=sales,o=acme?cn?base
- ldap:
- Erforderlich. Feste Protokollzeichenfolge.
- s:
- Optional. Gibt an, ob SSL verwendet werden soll. Standardmäßig wird SSL nicht verwendet.
- Server:
- Erforderlich. Der Name oder die IP-Adresse des LDAP-Servers, zu dem eine Verbindung hergestellt
werden soll.
- Port:
- Optional. Der Port für die Verbindung. Standardmäßig ist dies 389 (kein SSL). Für LDAP-Server
mit aktiviertem SSL wird in der Regel Port 636 verwendet.
- Basis-DN
- Erforderlich. Eine Zeichenfolge, die den Basis-DN aller Benutzer im Verzeichnis definiert. Wenn Benutzer in verschiedenen Unterverzeichnisstrukturen vorhanden sind, geben Sie eine gemeinsame Unterverzeichnisstruktur an, unter der eine Suche nach dem Benutzernamen den Eintrag auf eindeutige Weise in den erforderlichen Benutzereintrag auflöst, und legen Sie das Attribut sub fest.
- Benutzer-ID-Attribut:
- Optional. Eine Zeichenfolge, die das Attribut definiert, dem der ankommende Benutzername
zugeordnet werden soll, normalerweise 'uid', 'CN' oder 'emailaddress'. Der Standardwert ist
'uid'.
- base|sub:
- Optional. Legt fest, ob eine Basissuche oder Unterverzeichnisstruktursuche durchgeführt werden
soll. Bei Angabe von base geht die Authentifizierung schneller, weil der DN des Benutzers
aus der Kombination Benutzer-ID-Attribut + Benutzername + Basis-DN erzeugt werden kann. Bei Angabe
von sub muss eine Suche durchgeführt werden, damit der DN aufgelöst werden kann. Der
Standardwert ist sub.
- Legen Sie 'authorizationConfig' fest, und verwenden Sie dabei folgende Syntax:
ldap[s]://Server[:Port]/Gruppen-DN[?[Mitgliedsattribut][?[base|sub][?[x-userBaseDN=Basis-DN,x-uid_attr=Benutzer-ID-Attribut]]]]
Beispiel:
ldap://ldap.acme.com:389/cn=All Sales,ou=acmegroups,o=acme.com?uniquemember?sub?x-userBaseDN=ou=sales%2co=ibm.com,x-uid_attr=emailaddress
- ldap:
- Erforderlich. Feste Protokollzeichenfolge.
- s:
- Optional. Gibt an, ob SSL verwendet werden soll. Standardmäßig wird SSL nicht verwendet.
- Server:
- Erforderlich. Der Name oder die IP-Adresse des LDAP-Servers, zu dem eine Verbindung hergestellt
werden soll.
- Port:
- Optional. Der Port für die Verbindung. Standardmäßig ist dies 389 (kein SSL). Für LDAP-Server
mit aktiviertem SSL wird in der Regel Port 636 verwendet.
- Gruppen-DN
- Erforderlich. Der vollständige definierte Name der Gruppe, in der Benutzer Mitglied sein
müssen, damit ihnen Zugriff erteilt wird.
- Mitgliedsattribut:
- Optional. Das Attribut für die Gruppe, das zum Filtern der Suche verwendet wird. Standardmäßig
wird nach beiden Attributen, member und uniquemember, gesucht.
Die folgenden Optionen sind nur erforderlich, wenn der Autorisierung keine Authentifizierung vorausging und die Authentifizierungskonfigurationszeichenfolge nicht angegeben wurde. Wenn die
Authentifizierungskonfigurationszeichenfolge angegeben wurde, werden die folgenden Parameter
ignoriert und stattdessen die mit Basis-DN, Benutzer-ID-Attribut und [base|sub] übergebenen
Parameter für die Authentifizierung verwendet:
- base|sub:
- Optional. Legt fest, ob eine Basissuche oder Unterverzeichnisstruktursuche durchgeführt werden
soll. Bei Angabe von base geht die Authentifizierung schneller, weil der DN des Benutzers
aus der Kombination Benutzer-ID-Attribut + Benutzername + Basis-DN erzeugt werden kann. Bei Angabe
von sub muss eine Suche durchgeführt werden, damit der DN aufgelöst werden kann. Der
Standardwert ist sub.
- Basis-DN
- Optional. Eine Zeichenfolge, die den Basis-DN aller Benutzer im Verzeichnis definiert. Ihr muss
die Zeichenfolge x-userBaseDN vorangestellt sein.
Kommas im Basis-DN müssen als
%2c übergeben werden.
- Benutzer-ID-Attribut:
- Optional. Eine Zeichenfolge, die das Attribut definiert, dem der ankommende Benutzername
zugeordnet werden soll, normalerweise 'uid', 'CN' oder 'emailaddress'. Der Standardwert ist 'uid'. Der Zeichenfolge muss die Zeichenfolge x-uid_attr vorangestellt sein.
Wenn der Befehl aus einer Stapeldatei (BAT) oder Befehlsdatei (CMD) übergeben wird und die
LDAP-URL eine Erweiterung um einen Hexadezimalwert mit vorangestelltem Prozentzeichen als
Escapezeichen enthält (z. B. ein Komma, das durch
%2c ersetzt wurde, oder ein
Leerzeichen, das durch
%20 ersetzt wurde), muss diesen Prozentzeichen für den
Stapelinterpreter ein zusätzliches Prozentzeichen als Escapezeichen vorangestellt werden
(
%%).
Beispiel:
mqsicreateconfigurableservice WBRK_BROKER -c SecurityProfiles -o LDAP_URI_FUN -n
authentication,authenticationConfig,authorization,authorizationConfig -v
"LDAP,\"ldap://ldap.acme.com:389/ou=sales,o=acme.com?emailaddress?sub\",TRUE,LDAP,
\"ldap://ldap.acme.com:389/cn=All Sales,ou=acmegroups,
o=acme.com?report?base?x-BaseDN=ou=sales%%2co=acme.com,x-uid_attr=emailaddress\""
Die ausgewählte Gruppe muss auf dem LDAP-Server definiert sein, und alle erforderlichen Benutzer
müssen Mitglied der Gruppe sein.