API-Schlüssel und -Zertifikat für Agenten überprüfen und zurücksetzen

Sie können den API-Schlüssel eines Agenten anzeigen und zurücksetzen.

Informationen zu diesem Vorgang

API-Schlüssel ermöglichen Agenten den Zugriff auf den IBM® UrbanCode Deploy-Server. Ohne den richtigen API-Schlüssel können der Server und der Agent keine Nachrichten austauschen. Der Server weist Nachrichten zurück, die von dem Agenten stammen, wenn diese Nachrichten nicht mit dem Schlüssel verschlüsselt wurden. Umgekehrt weist der Agent Nachrichten zurück, die vom Server stammen, wenn diese Nachrichten nicht mit dem Schlüssel verschlüsselt wurden. Ohne den Schlüssel kann niemand abgefangene Nachrichten zwischen dem Server und dem Agenten lesen.

Der Server generiert den API-Schlüssel, wenn der Agent diesen zum ersten Mal anfordert. Anschließend wird die Identität des Agenten als Zertifikat, das der Agent bereitstellt, erfasst. Nur diese Identität kann anfordern, dass ein neuer Schlüssel generiert wird, um den vorhandenen Schlüssel zu ersetzen. Wenn ein Schlüssel verloren geht, etwa wenn ein Agent erneut installiert oder beschädigt wird, wird das Abrufen oder Generieren genau desselben Schlüssels nicht unterstützt. Sie müssen den alten Schlüssel widerrufen und einen neuen erstellen.

Vorgehensweise

  • Gehen Sie wie folgt vor, um den Schlüssel eines Agenten anzuzeigen und erneut zu generieren.
    1. Wählen Sie auf dem Server Einstellungen aus und klicken Sie dann unter "Sicherheit" auf API-Schlüssel und -Zertifikate. Das Fenster API-Schlüssel wird geöffnet. In diesem Fenster werden die API-Schlüssel angezeigt, die von Agenten dazu verwendet werden, eine Verbindung zum Server herzustellen.
    2. Widerrufen Sie im Fenster API-Schlüssel den API-Schlüssel für den Agenten, indem Sie den Schlüssel auswählen und auf Aktionen > Widerrufen klicken. Um den Schlüssel zu finden, der einem Agenten zugeordnet ist, öffnen Sie die Agenteneigenschaften und suchen Sie die Eigenschaft sys.locked/agent.id. Der API-Schlüssel des Agenten beginnt mit ucd-agent- und dem Wert der Eigenschaft sys.locked/agent.id.
    3. Löschen Sie auf dem System, das den Agenten hostet, die Datei conf/agent/agent-key.properties.
    4. Starten Sie den Agenten erneut.
    5. Vergewissern Sie sich, dass der Agent eine Verbindung zum Server herstellen kann.

    Feedback