Verbinden Sie den Service Desk-Mitarbeiter mit dem MID-Server MTLS wird verwendet

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 TLS-Authentifizierung (Transport Layer Security) ermöglichen.

    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 zentralen MID-Schlüsselspeicher, und richten Sie den ein MID-Webserver
    3. Verbinden Sie den Service Desk-Mitarbeiter mit dem MID-Webserver Mit TLS
    4. mTLS-Authentifizierung für einen MID-Webserver konfigurieren
    5. Verbinden Sie den Service Desk-Mitarbeiter mit dem MID-Server MTLS wird verwendet

    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 Service Desk-Mitarbeiter im 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>"

      Zum 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 Service Desk-Mitarbeiter. 
      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. In Laborwert Ordner, kopieren Sie Ihre Schlüssel- und Zertifikatdateien auf die virtuelle Maschine des Agent-Hosts. 
      cp ./acc.key <agent host config folder>
cp ./acc.crt <agent host config folder>

      Die Pfade des Konfigurationsordners 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, an den Sie kopiert haben .Schlüssel Und .crt Dateien von.
    6. Führen Sie die folgenden Befehle aus, um die Leseberechtigungen der Dateien zu aktualisieren und dem Service Desk-Mitarbeiter zu ermöglichen, daraus zu lesen.
      • Linux:
        1. Chown servicenow:servicenow acc.key
        2. Chmod 0400 acc.key
      • Windows:
        1. Wählen Sie aus, und halten Sie (oder klicken Sie mit der rechten Maustaste) .Schlüssel Datei und wählen Sie aus Sicherheit Registerkarte in den Dateieigenschaften.
        2. Fügen Sie hinzu servicenowAnwender zur Liste der Anwender mit Lesezugriff auf die Datei.
      • macOS:
        1. Chown _servicenow:_servicenow acc.key
        2. Chmod 0400 acc.key
      Hinweis:
      Der Service Desk-Mitarbeiter muss mit dem standardmäßigen servicenow-Anwender 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 Service Desk-Mitarbeiter neu.
      • Linux: Systemctl Neustart gemäß
      • Windows:
        1. Öffnen Sie die Anwendung Services.
        2. Wählen Sie aus, und halten Sie (oder klicken Sie mit der rechten Maustaste) Agent Client Collector Eintrag und auswählen Starten Sie Neu .
      • macOS:
        1. Launchctl entladen – 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 Service Desk-Mitarbeiter über 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 von angegebene Standort Protokolldatei Konfigurationskennzeichnung. 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 Standardstandort ist: /Library/Application\ Support/servicenow/Agent-Client-Collector/log/acc.log