Skip to main content

Verwenden von Notebook-Secrets

Secrets in ArcGIS Notebooks bieten eine sichere Methode zum Speichern und Verwenden vertraulicher Informationen, wie beispielsweise Schlüssel zur Verbindung mit externen Systemen. Diese Funktion wird für Notebooks unterstützt, auf denen Notebook Runtime 14.0 oder höher installiert ist.

Wenn Sie über die Berechtigung zum Erstellen von Notebooks verfügen, können Sie Secrets im Bereich "Secrets" für ein Notebook erstellen und verwalten. Alle von Ihnen registrierten Secrets werden in diesem Fenster angezeigt, sodass Sie diese programmgesteuert in Ihren Notebooks hinzufügen und verwenden können – sowohl für interaktive als auch für geplante Workflows –, ohne fest codierte Secret-Werte offenzulegen.

Achtung:

Schreiben Sie keine Secret-Werte in Ihr Notebook, um zu verhindern, dass diese offengelegt werden.

Hinweis:

Wenn ein Notebook, das auf ein registriertes Secret verweist, für einen anderen Notebook-Autor freigegeben wird, steht diesem Autor der Wert des Secrets nicht zur Verfügung. Gemeinsame Benutzer können im Notebook eigene Secrets mit demselben Namen erstellen.

Secrets werden in Notebook-Web-Werkzeugen nicht unterstützt, da diese von mehreren Benutzern freigegeben und ausgeführt werden.

Registrieren eines Secrets

Über den Bereich Secrets im Notebook-Editor können Sie ein oder mehrere Secrets für die Verwendung in Ihrem Notebook erstellen. Führen Sie die folgenden Schritte aus, um ein Secret zu registrieren:

  1. Befolgen Sie die Schritte, um ein Notebook zu öffnen.

  2. Klicken Sie auf Secrets im oberen Menüband des Notebook-Editors.

  3. Klicken Sie auf Secret registrieren.

  4. Geben Sie einen Namen und einen Wert für das Secret an.

    Der Name darf alphanumerische Zeichen, Bindestriche und Unterstriche enthalten und darf maximal 255 Zeichen lang sein. Der Secret-Wert darf nicht länger als 5000 Zeichen sein.

  5. Klicken Sie auf Speichern.

Hinzufügen eines Secrets zu einem Notebook

  1. Klicken Sie auf Secrets im oberen Menüband des Notebook-Editors.

  2. Klicken Sie auf + Hinzufügen, um einen Codeausschnitt in Ihr Notebook einzufügen, der den Wert des Secrets abruft.

  3. Ersetzen Sie den Variablennamen im Codeausschnitt durch den von Ihnen gewünschten Namen.

Aktualisieren eines Secrets

Um den Wert eines registrierten Secrets zu aktualisieren, müssen Sie das Secret löschen und ein neues Secret mit demselben Namen registrieren.

Festlegen des Schlüssels

Sie können optional einen Schlüssel festlegen, der zum Ver- und Entschlüsseln Ihrer registrierten Secrets verwendet wird. Wenn Sie keinen Schlüssel angeben, wird ein Standardschlüssel verwendet. Führen Sie die folgenden Schritte aus, um einen Schlüssel festzulegen oder einen vorhandenen Schlüssel zu aktualisieren:

  1. Befolgen Sie die Schritte, um ein Notebook zu öffnen.

  2. Klicken Sie auf Secrets im oberen Menüband des Notebook-Editors.

  3. Klicken Sie auf Schlüssel festlegen.

  4. Geben Sie den Wert für den Schlüssel ein.

  5. Klicken Sie auf Speichern.