Zum Hauptinhalt springen

Devin Anmeldedaten bereitstellen

Devin kann eigene Anmeldedaten verwenden, um auf Plattformen zuzugreifen, die eine Authentifizierung erfordern, entweder in seinem Browser oder über die Kommandozeile. Wir empfehlen, für Devin auf jedem Dienst, auf den er zugreifen muss, ein eigenes Konto einzurichten (z. B. devin@company.com). Anschließend können Sie Devins Benutzernamen und Passwort als Secrets in Ihrem Konto speichern, damit er sich im Rahmen zukünftiger Sitzungen anmelden kann. Das Hinzufügen von Secrets erfolgt in erster Linie über die Secrets-Seite. Diese Seite ist insbesondere für Secrets auf Organisationsebene relevant. Für Repo-spezifische oder sitzungsspezifische Secrets siehe die folgenden Abschnitte. Um mehrere Secrets auf einmal hinzuzufügen, klicken Sie neben Add secret auf Bulk add secrets. Laden Sie anschließend eine .env-Datei (bis zu 2 MB) hoch oder fügen Sie die Einträge im Format KEY=value ein, jeweils einen pro Zeile. Cookies und TOTP-Codes müssen einzeln hinzugefügt werden.
Devin
Wenn Sie ein Secret hinzufügen, können Sie eine Notiz ergänzen, die zusätzlichen Kontext oder Anweisungen zur Verwendung des Secrets enthält. Verwenden Sie dieses Feld, um nützliche Informationen sowohl an Devin als auch an die übrigen Mitglieder Ihrer Organisation zu übermitteln. Beispiel-Notizen könnten sein:
  • Dieser API-Schlüssel darf nur in unserer Produktionsumgebung verwendet werden, aber niemals in Staging oder Dev.
  • Wird für unsere AWS-RDS-Datenbank in us-west-2 verwendet
  • Diese Anmeldedaten werden nach Q3 2025 außer Betrieb genommen
  • Läuft automatisch alle 30 Tage ab – kontaktieren Sie das SecOps-Team für eine Rotation, falls dies fehlschlägt
  • Dieser API-Schlüssel ist mit dem Benutzerkonto devin@company.com verknüpft
Unter More controls im Formular New secret ist Redact value standardmäßig aktiviert. Ein geschwärzter Wert lässt sich nicht erneut anzeigen. Um ihn zu ändern oder Redact value zu deaktivieren, öffnen Sie das Secret, klicken Sie auf Edit und geben Sie einen neuen Wert ein.

Dauerhaft gespeicherte globale Secrets

Secrets, die in den Settings → Resources → Secrets hinzugefügt werden, werden dauerhaft gespeichert und gelten für zukünftige Sitzungen in der gesamten Organisation. Beachten Sie, dass alle Secrets, die Sie hier hinzufügen, von Devin in allen zukünftigen Devin-Sitzungen innerhalb Ihrer Organisation verwendet werden können. Alle Secrets werden im Ruhezustand verschlüsselt. Alle Mitglieder Ihrer Organisation können globale Secrets in ihren Sitzungen verwenden. Standardmäßig können sie diese auch erstellen, bearbeiten und löschen, da die Standardrolle Member die Berechtigung Manage secrets enthält. Achten Sie darauf, nur Secrets hinzuzufügen, die speziell auf Ihre Organisation zugeschnitten und für alle ihre Mitglieder nutzbar sind. In Devin Enterprise kann ein Enterprise-Administrator die Berechtigung Manage secrets aus der organisationsweiten Rolle Member entfernen und sie stattdessen über eine benutzerdefinierte Rolle vergeben; siehe Custom Roles & RBAC.

Persönliche Secrets

Zusätzlich zu organisationsweiten Secrets können Sie persönliche Secrets erstellen, die nur für Ihre eigenen Sitzungen gelten. Persönliche Secrets werden nicht mit anderen Mitgliedern Ihrer Organisation geteilt. Das ist nützlich für Anmeldedaten, die mit Ihren persönlichen Accounts verknüpft sind, oder zum Testen von Secrets, die nicht dem gesamten Team offengelegt werden sollten. Um ein persönliches Secret zu erstellen, wählen Sie beim Hinzufügen eines neuen Secrets auf der Secrets-Seite den Geltungsbereich Personal aus. Persönliche Secrets sind nur in Sitzungen zugänglich, die Sie erstellen, und sind für andere Mitglieder der Organisation oder Admins nicht sichtbar. Es gibt mehrere Arten von Secrets:
Dies ist am besten geeignet für generische Secrets mit einem einzelnen Wert. Wählen Sie im Feld Type die Option Key-value aus. Jeder Secret Name (auch bekannt als Secret Key) ist einem einzelnen Secret Value zugeordnet. Beispiele für Secrets, die hier gespeichert werden können, sind:
  • API-Schlüssel
  • SSH Keys
  • Benutzernamen oder Passwörter
  • Tokens
Wenn ein einzelnes Secret mehrere Werte benötigt, erstellen Sie bitte ein separates Secret für jeden Wert. Sie könnten beispielsweise GITHUB_USERNAME und GITHUB_PASSWORD als zwei Raw Secrets speichern. Ein Beispiel, bei dem ein API-Schlüssel als mehrere Raw Secrets gespeichert wird, finden Sie unter Upload iOS builds to TestFlight.
Zeitbasierte Einmalpasswörter werden für Zwei-Faktor-Authentifizierung (2FA) verwendet. Devin kann TOTP-Secrets speichern, die ähnlich funktionieren wie in Google Authenticator oder Authy. Details zum Hinzufügen eines TOTP-Secrets finden Sie unter Adding a New TOTP
Devin unterstützte früher Secrets, die mehrere Keys pro Secret abbilden konnten. Diese Funktion ist jedoch nicht mehr verfügbar.Stattdessen empfehlen wir, einfach für jedes einzelne Feld ein Key-value-Secret anzulegen. Anstatt beispielsweise ein Secret für JIRA_LOGIN zu erstellen, könnten Sie zwei Secrets anlegen: JIRA_USERNAME und JIRA_PASSWORD.

Bot-spezifische Secrets

Ein Devin Bot kann zusätzlich zu den Secrets Ihrer Organisation eigene Secrets enthalten, die nur dieser Bot und seine Sitzungen verwenden. Diese fügen Sie in den Einstellungen des Bots auf der Seite Secrets hinzu. Weitere Informationen finden Sie unter Verbindungen und Secrets von Devin Bots.

Repo-spezifische Secrets

Um Secrets auf ein bestimmtes Repository zu beschränken, fügen Sie sie im Blueprint-Editor dieses Repositorys hinzu:
  1. Gehen Sie zu Settings > Environment > Blueprints und wählen Sie das Repository aus. Das Repository muss bereits Teil Ihrer Environment sein.
  2. Öffnen Sie den Tab Secrets.
  3. Klicken Sie auf Create secret, um ein einzelnes Secret hinzuzufügen, oder auf Import secrets, um mehrere auf einmal hinzuzufügen.
Im selben Tab können Sie die Secrets des Repositorys durchsuchen, anzeigen, bearbeiten und löschen. Zum Erstellen, Bearbeiten und Löschen von Repository-Secrets ist die Berechtigung Manage secrets erforderlich, die in der Standardrolle Member enthalten ist. Repository-Secrets stehen ausschließlich diesem Repository zur Verfügung: dessen Blueprint-Schritten während Snapshot-Builds sowie Devin, wenn Devin in Sitzungen in diesem Repository arbeitet. Sie werden verschlüsselt gespeichert und niemals in Ihren Blueprint oder Snapshot geschrieben. Wie sie eingefügt werden, erfahren Sie unter Secrets in der Blueprint-Referenz.
Tragen Sie keine Secret-Werte in Blueprint-YAML, Setup-Befehle oder .env-Dateien ein, die ins Repository committet werden. Speichern Sie sie stattdessen im Tab Secrets des Repositorys und referenzieren Sie sie über ihren Namen (zum Beispiel $MY_SECRET).

Sitzungsspezifische Secrets

Während Devin arbeitet, kann Devin Sie im aktuellen Gespräch auffordern, Anmeldedaten (API-Schlüssel, Logins usw.) anzugeben, etwa so:
Devin
Ein Secret auf dieser Karte gilt nur für die aktuelle Sitzung, sofern Save for future sessions nicht ausgewählt ist. Devin kann diese Option bereits vorauswählen. Prüfen Sie sie daher, bevor Sie das Secret senden. Alternativ können Sie sitzungsspezifische Secrets auch selbst festlegen:
Devin

Arbeiten mit Secrets

Devin stellt jedes Secret genau den Befehlen und Tools bereit, die es benötigen. Im Browser gibt Devin den Wert direkt ein. Bei Shell-Befehlen bindet Devin Secrets bei Bedarf als Umgebungsvariablen ein. Dies gilt für organisationsweite, repo-spezifische und sitzungsspezifische Secrets. Secrets werden nicht in jede Shell exportiert, daher sollten Skripte nicht davon ausgehen, dass eine Variable wie $API_KEY bereits gesetzt ist. Wenn ein Skript ein Secret benötigt, teile Devin mit, welche Umgebungsvariable es ausliest, und Devin bindet sie an die entsprechenden Befehle. Organisations- und persönliche Secrets verfügen im Formular New secret unter More controls über einen Schalter Require approval before each use. Standardmäßig ist er deaktiviert. Devin nimmt einige Umwandlungen am Namen vor, um sicherzustellen, dass deine Secrets gültige ENV-Variablen sind:
  • Ungültige Zeichen werden entfernt, indem alles, was kein Buchstabe, keine Ziffer oder kein Unterstrich ist, durch einen Unterstrich ersetzt wird. Zum Beispiel würde das Secret mit dem Namen Abc%123 zur ENV-Variable Abc_123 werden.
  • Wenn dein Secret-Name mit einer Ziffer beginnt, fügt Devin am Anfang des Namens einen Unterstrich hinzu. Zum Beispiel würde das Secret 123MYVAR zur ENV-Variable _123MYVAR werden (Namen, die bereits mit einem Buchstaben oder Unterstrich beginnen, bleiben unverändert).
  • Wenn du zwei Secrets mit demselben Namen hast, fügt Devin am Ende einen Zähler hinzu. Zum Beispiel erhältst du, wenn du zwei Secrets namens MY_SECRET hast, zwei ENV-Variablen mit den Namen MY_SECRET und MY_SECRET_2 und so weiter.
Um ein Website-Cookie hinzuzufügen, führen Sie bitte die folgenden Schritte aus:
  1. Melden Sie sich wie gewohnt bei dem Konto an, das Sie mit Devin teilen möchten. Dadurch werden Cookies erzeugt.
  2. Fügen Sie die exportierten Cookies über die Secrets-Seite zu Devin hinzu.
  3. Wenn Devin die Cookies für eine Website verwendet, sollte es beim Aufruf dieser Website feststellen, dass es bereits angemeldet ist. Bitten Sie Devin, es auszuprobieren!
Wenn Sie nicht Chrome verwenden, wählen Sie im Formular New secret die Option JSON aus und fügen Sie die Cookies als JSON ein. Wenn Sie Cookies manuell kodieren, wählen Sie base64 aus. Devin erwartet eine Base64-codierte Zeichenkette, die aus durch ; getrennten JSON-Objekten im Standard-Chromium-Cookieformat besteht.

Hinzufügen eines neuen TOTP

Devin kann jetzt Zwei-Faktor-Authentifizierung (2FA) mit einem zeitbasierten Einmalpasswort (TOTP) unterstützen. Dazu musst du Devin die Informationen bereitstellen, die du beim Einrichten von 2FA in Devins Konto für die jeweilige Anwendung erhalten hast:
  1. Melde dich bei Devins Konto für den Dienst an, der 2FA erfordert.
  2. Gehe zu den Sicherheitseinstellungen des Kontos und suche nach einer Option, um den QR-Code neu zu generieren oder anzuzeigen. Diese Option kann z. B. „Set up“ oder „Replace Authenticator“ heißen.
  3. Falls die Anwendung dies unterstützt, wähle die Option zum Anzeigen des QR-Codes.
  4. Sobald der QR-Code auf deinem Bildschirm angezeigt wird, mache einen Screenshot.
  5. Gehe zu Devin’s Secrets, klicke auf die Schaltfläche Add secret und ändere den Type auf Einmalpasswort (TOTP). Vergib einen aussagekräftigen Namen. Klicke auf das kleine QR-Code-Symbol oben rechts im Wert-Eingabefeld und lade deinen QR-Code-Screenshot hoch. Alternativ kannst du auch eine otpauth://totp/-URI einfügen.
Gib nur 2FA-Codes für Konten an, die ausschließlich für die Nutzung durch Devin eingerichtet wurden. Wir empfehlen nicht, Devin irgendwelche 2FA-Codes für deine persönlichen Konten weiterzugeben.

Tipps für TOTPs

  • Einige Anwendungen erlauben es möglicherweise nicht, den vorhandenen QR-Code anzuzeigen, sobald 2FA aktiviert wurde. In solchen Fällen bleibt nur, den QR-Code neu zu generieren.
  • Bewahren Sie alle neuen Backup-Codes, die Sie während des Vorgangs erhalten, immer an einem sicheren Ort auf.