Verbinden Sie den -Agent über mTLS mit MID-Server.

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Bevor Sie die mTLS-Authentifizierung für den -Agent konfigurieren, müssen Sie eine Reihe von Befehlen ausführen, die die Konfiguration der Transport Layer Security-Authentifizierung (TLS) aktivieren.

    Vorbereitungen

    Stellen Sie sicher, dass Sie die folgenden Aufgaben ausgeführt haben:
    1. Erstellen Sie Schlüssel und Zertifikate
    2. Installieren Sie die PEM-Datei im einheitlichen MID-Schlüsselspeicher, und richten Sie die ein MID-Webserver
    3. Verbinden Sie den -Agent per TLS mit MID-Webserver
    4. mTLS-Authentifizierung für einen MID-Webserver konfigurieren
    5. Verbinden Sie den -Agent über mTLS mit MID-Server.

    Erforderliche Rolle: agent_client_collector_admin

    Prozedur

    1. Generieren Sie einen Schlüssel für Ihren Service Desk-Mitarbeiter. 
      openssl ecparam -out labacc/acc.key -name prime256v1 -genkey
    2. Generieren Sie eine Zertifikatanforderung für Ihren Agent gemäß dem folgenden Format: 
      openssl req -new -key labacc/acc.key -out labacc/acc.csr -subj "/C=<country>/ST=<state>/L=<location>/O=<organization>/OU=<organization unit>/CN=<cn abbreviation>/emailAddress=<email address>"

      Beispiel:

      openssl req -new -key labacc/acc.key -out labacc/acc.csr -subj "/C=US/ST=NC/L=Raleigh/O=ServiceNow/OU=ITOM Lab/CN=acclinux/emailAddress=john.smith@servicenow.com"
    3. Generieren Sie ein signiertes Zertifikat für Ihren Agent. 
      openssl x509 -req -days 365 -in labacc/acc.csr -CA labca/labcacert.pem -CAkey labca/ec-labcakey.pem -CAcreateserial -extensions client -out labacc/acc.crt
    4. Kopieren Sie im Ordner „ labacc “ Ihre Schlüssel- und Zertifikatdateien in den virtuellen Computer des Agent-Hosts. 
      cp ./acc.key <agent host config folder>
cp ./acc.crt <agent host config folder>

      Die Pfade zum Konfigurationsordner hängen von Ihrem Betriebssystem ab.

      • Linux: /etc/servicenow/agent-client-collector/
      • Windows: C:\ProgramData\servicenow\agent-client-collector\config\
      • macOS: /Library/Application\ Support/servicenow/agent-client-collector/
    5. Navigieren Sie zu dem Speicherort, von dem Sie die Dateien .key und .crt aus kopiert haben.
    6. Führen Sie die folgenden Befehle aus, um die Leseberechtigungen der Dateien zu aktualisieren und dem Agent das Lesen von Dateien zu ermöglichen.
      • Linux:
        1. ausgewählten servicenow:servicenow acc.key
        2. chmod 0400 acc.key
      • Windows:
        1. Wählen und halten Sie die Datei .key (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie in den Dateieigenschaften die Registerkarte Sicherheit aus.
        2. Fügen Sie den Anwender servicenow der Liste der Anwender mit Lesezugriff auf die Datei hinzu.
      • macOS:
        1. chown _servicenow:_servicenow acc.key
        2. chmod 0400 acc.key
      Hinweis:
      Der Agent muss mit dem ServiceNow-Standardanwender ausgeführt werden.
    7. Fügen Sie in der Konfigurationsdatei acc.yml die folgenden Parameter hinzu, um den Pfad zu Ihren Schlüssel- und Zertifikatdateien anzugeben. 
      key-file: "<path to acc.key file>/acc.key"
cert-file: "<path to acc.cert file>/acc.crt"
    8. Starten Sie den Agent neu.
      • Linux: systemctl-Neustart gemäß
      • Windows:
        1. Öffnen Sie die Anwendung Services.
        2. Wählen Sie den Eintrag Agent Client Collector aus, und halten Sie ihn, (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Neu startenaus.
      • macOS:
        1. launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
        2. launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist
    9. Überprüfen Sie die Protokolle, um sicherzustellen, dass der Agent mithilfe von TLS eine Verbindung zur Instanz herstellen konnte.

      Agent Client Collector Protokolle sind zugänglich von:

      • Linux: /var/log/servicenow/agent-client-collector/acc.log
      • Windows: Der durch die Protokolldatei- Konfigurationskennzeichnung angegebene Speicherort. Der Standardspeicherort lautet: C:/ProgramData/ServiceNow/agent-client-collector/log/acc.log.

        Wenn das Verzeichnis C:/ProgramData ausgeblendet ist (z. B. bei älteren Windows-Versionen), ändern Sie den Explorer-Filter, um ausgeblendete Elemente anzuzeigen.

      • macOS: Der Standardspeicherort lautet: /Library/Application\ Support/servicenow/agent-client-collector/log/acc.log