Citrix ADC

Citrix ADC als OAuth SP

Die Authentifizierungs-, Autorisierungs- und Überwachungsfunktion des Datenverkehrs unterstützt die OAuth-Authentifizierung, um Benutzer bei Anwendungen zu authentifizieren, die in Anwendungen wie Google, Facebook und Twitter gehostet werden.

Punkte zu beachten

  • Citrix ADC Advanced Edition und höher ist erforderlich, damit die Lösung funktioniert.
  • OAuth auf der Citrix ADC Appliance ist für alle SAML-IDPs qualifiziert, die mit “OpenID connect 2.0” kompatibel sind.

So konfigurieren Sie OAuth mithilfe des Konfigurationsdienstprogramms

  1. Konfigurieren Sie die OAuth-Aktion und -Richtlinie.

    Navigieren Sie zu Sicherheit > AAA - Anwendungsverkehr > Richtlinien > Authentifizierung > Erweiterte Richtlinien > Richtlinie, erstellen Sie eine Richtlinie mit OAuth als Aktionstyp, und ordnen Sie der Richtlinie die erforderliche OAuth-Aktion zu.

  2. Ordnen Sie die OAuth-Richtlinie einem virtuellen Authentifizierungsserver zu.

    Navigieren Sie zu Sicherheit > AAA - Anwendungsdatenverkehr > Virtuelle Server, und ordnen Sie die OAuth-Richtlinie dem virtuellen Authentifizierungsserver zu.

Hinweis: Attribute (1 bis 16) können in der OAuth-Antwort extrahiert werden. Derzeit werden diese Attribute nicht ausgewertet. Sie werden für die zukünftige Referenz hinzugefügt.

So konfigurieren Sie OAuth mit der Befehlszeilenschnittstelle:**

  1. Definieren Sie eine OAuth-Aktion.

    add authentication OAuthAction <name> -authorizationEndpoint <URL> -tokenEndpoint <URL> [-idtokenDecryptEndpoint <URL>] -clientID <string> -clientSecret <string> [-defaultAuthenticationGroup <string>][-tenantID <string>][-GraphEndpoint <string>][-refreshInterval <positive_integer>] [-CertEndpoint <string>][-audience <string>][-userNameField <string>][-skewTime <mins>][-issuer <string>][-Attribute1 <string>][-Attribute2 <string>][-Attribute3 <string>]...
    
  2. Ordnen Sie die Aktion einer erweiterten Authentifizierungsrichtlinie zu.

    add authentication Policy** <name> -rule <expression> -action <string>
    

    Beispiel: add authentication oauthAction a -authorizationEndpoint https://example.com/ -tokenEndpoint https://example.com/ -clientiD sadf -clientsecret df

Weitere Hinweise zu Authentifizierungsparametern von OAuthAction finden Sie unterauthentication OAuthAction.

Hinweis: Wenn ein CertEndPoint angegeben wird, fragt die Citrix ADC Appliance den Endpunkt mit der konfigurierten Frequenz ab, um die Schlüssel zu lernen.

Um einen Citrix ADC so zu konfigurieren, dass die lokale Datei gelesen und die Schlüssel aus dieser Datei analysiert werden, wird eine neue Konfigurationsoption wie folgt eingeführt:

set authentication OAuthAction <> -**CertFilePath** <path to local file with jwks>

Name-Wert-Attributunterstützung für die OAuth-Authentifizierung

Sie können nun OAuth-Authentifizierungsattribute mit einem eindeutigen Namen zusammen mit den Werten konfigurieren. Die Namen werden im OAuth-Aktionsparameter entweder als Attribute konfiguriert und die Werte werden durch Abfrage der Namen abgerufen. Die extrahierten Attribute werden in Authentifizierungs-, Autorisierungs- und Überwachungssitzung gespeichert. Administratoren können diese Attribute entweder mithttp.req.user.attribute("attribute name") oderhttp.req.user.attribute(1) anhand der gewählten Methode zur Angabe von Attributnamen abfragen.

Durch die Angabe des Namens des Attributs können Administratoren problemlos nach dem Attributwert suchen, der diesem Attributnamen zugeordnet ist. Auch Administratoren müssen sich nicht mehr an das Attribut attribute1 to attribute16 erinnern.

Wichtig: In einem OAuth-Befehl können Sie maximal 64 durch Komma getrennte Attribute mit einer Gesamtgröße von weniger als 1024 Byte konfigurieren.

Hinweis: Der Sitzungsfehler kann vermieden werden, wenn die Gesamtwertgröße von “Attribut 1 bis Attribut 16” und die Werte der Attribute, die in “Attribute” angegeben sind, nicht mehr als 10 KB betragen.

So konfigurieren Sie die Name-Wert-Attribute mit der CLI

Geben Sie an der Eingabeaufforderung Folgendes ein:

  • add authentication OAuthAction <name> [-Attributes <string>]
  • set authentication OAuthAction <name> [-Attributes <string>]

Beispiele:

  • add authentication OAuthAction a1 –attributes "email,company" –attribute1 email
  • set authentication OAuthAction oAuthAct1 -attributes "mail,sn,userprincipalName"

Citrix ADC als OAuth SP