Skip to content

Registrierung und Einrichtung der Zwei-Faktor-Authentifizierung

Diese Dokumentation führt Sie Schritt für Schritt durch den Registrierungsprozess von openCode.

Um einen neuen Account auf openCode zu erstellen, müssen sie folgende zwei Schritte befolgen:

  1. Ausfüllen des Registrierungsformulars
  2. Bestätigung ihrer E-Mail-Adresse
  3. Einrichtung der Zwei-Faktor-Authentifizierung

Probleme oder Fragen?

Sie haben Probleme bei der Erstellung von Projekten, dann lesen sie am besten den Abchnitt zu häufig gestellte Fragen und Problemen bei der Registierung

Schritt für Schritt-Anleitung zur Registierung auf openCode

1. Ausfüllen des Registrierungsformulars

Öffnen sie dieses Seite um sich für die Nutzung von openCode zu registrieren:

Registrierungungsformular für openCode

  • Sie müssen hier zunächst

    Info

    Für den Zugriff auf den gesamten Funktionsumfang von openCode ist eine E-Mail-Adresse erforderlich, die der öffentlichen Verwaltung angehört.

  • Weiterhin ist für eine Nutzung von openCode als Teil der Öffentlichen Verwaltung notwendig, dass Sie mit einer Vertretungsmacht ausgestattet sind. Dies müssen Sie durch einen entsprechenden Haken bestätigen.

  • Eine anonyme Nutzung ist nur dann zu empfehlen, wenn sie sicher sind, dass sie keine Projekte veröffentlichen wollen. Ansonsten ist es zu empfehlen an dieser Stelle keinen Haken zu setzen. Falls sie sich unsicher über diese Option sind, können Sie diese Einstellung nachher aber auch noch jederzeit wieder Rückgängig machen.

Beenden sie diesen Schritt und Bestätigen sie ihre Angaben, indem sie nun auf "Jetzt Registrieren" drücken.

2. Bestätigung ihrer E-Mail-Adresse

Warnung

Falls sie noch keine Authentificator-App auf einem Zweitgerät eingerichtet haben, befolgen sie zuvor folgende Schritte, um eine solche App zu installieren.

Falls sie bereits eine Authentificator-App installiert haben, drücken sie in der entsprechenden E-Mail in ihrem Posteingang zur Bestätigung auf "Jetzt verifizieren".

Jetzt öffnet sich in ihrem Internet-Browser eine Seite zur EInrichtung der Zwei-Faktor-Authentifizierung. Fahren sie daher nun mit dem nächsten Schritt fort.

3. Einrichtung der Zwei Faktor-Authentifizierung

Einrichtung der Zwei-Faktor-Authentifizierung

  • Wählen sie an dieser Stelle am besten zunächst einen aussagekräftigen Gerätenamen und füllen sie das entsprechende Eingabefeld aus. Diese Angabe ist optional, kann ihnen aber helfen ihren zweiten Faktor besser zu identifizieren (je nach genutzer App kann es auch bei Auslassung dieses Felds zu Problemen kommen).
  • Generieren sie nun über eine Authentificator-App einen Anmeldecode. Falls sie noch keine Authentificator-App eingerichtet haben folgen sie folgenden Schritten:

Einrichtung und Nutzung einer Authentificator-App für die Zwei-Faktor-Authentifizierung

  1. Installation einer Authentificator-App (z.B. FreeOTP) auf einem zweiten Gerät, wie z.B. einem Smartphone:

  2. Einrichtung der Authentificator-App FreeOTP:

    • Öffnen sie zunächst die FreeOTP-App auf ihrem Smartphone.
    • Drücken sie nun auf das QR-Tag-Symbol in der oberen Leiste der App:

    FreeOTP: Scannen des einmaligen Anmelde-Codes

    • Scannen sie nun mithilfe ihres Smartphone den QR-Tag auf der Webseite zur Einrichtung der 2FA (sichtbar im obigen Screenshot).
    • Wählen sie sie nun ein beliebiges Icon aus.
    • Nun sehen sie in der FreeOTP-App eine Übersicht von verschiedenen Schaltflächen zur Generierung von Anmelde-Codes:

    FreeOTP: Überblick über die Token

    • Nach einem Drücken auf die nun neu hinzugefügte Schaltfäche "OS opencode Keycloak" wird ihnen für ein kurzes Zeitfenster ein Anmelde-Code angezeigt:

    FreeOTP: Generierung eines Anmelde-Codes

    • Übertragen sie diesen Anmelde-Code jetzt in das Eingabefeld "One-time Code (Pflichtfeld)" auf der Webseite und wählen sie über das Eingabefeld "Gerätename" eine aussagekräftige Bezeichnung, wie z.B. "openCode".
    • Klicken sie zum Abschluss auf der Webseite die Schaltfläche "2FA Authentifizierung abschliessen".
    • Nun sollten sie über ihr Smartphone Anmelde-Codes für die Anmeldung bei openCode generieren können.

Häufig gestellte Fragen und Probleme

Was ist eine Zwei-Faktor-Authentifizierung?

Die Zwei-Faktor-Authentifizierung (abgekürzt als 2FA) ist ein Sicherheitsmechanismus, der den Zugang zu ihrem openCode-Konto schützt. Dabei werden zwei verschiedenen Faktoren zur Verifizierung der Identität des Benutzers benutzt.

Diese zwei Faktoren bestehen üblicherweise aus:

  • Erster Faktor: Etwas, das der Benutzer weiß – in der Regel ein Passwort oder eine PIN.
  • Zweiter Faktor: Etwas, das der Benutzer besitzt – beispielsweise ein Smartphone, auf das ein Einmalcode gesendet wird, oder ein spezielles Sicherheitsgerät.

Durch die Kombination dieser beiden Faktoren wird die Sicherheit erheblich erhöht, da ein Angreifer sowohl das Passwort als auch das zweite Authentifizierungsmittel benötigen würde, um Zugang zum Konto zu erhalten.

Dies minimiert das Risiko unbefugter Zugriffe, selbst wenn das Passwort kompromittiert wird.

Für den zweiten Faktor bei openCode wird auf einem mobilen Endgerät eine sogenannte TOTP-App installiert, welche Ihnen bei Ihrer Anmeldung einen Anmeldecode generiert.

Diesen Code müssen Sie bei jeder Anmeldung jeweils neu über die App generieren.

Einige bekannte TOTP-Apps:

Wie kann ich openCode nutzen, wenn ich nicht der öffentlichen Verwaltung angehöre?

Auch wenn sie nicht der öffentlichen Verwaltung angehören können sie:

  • Code zu Projekten beitragen
  • Fehler melden
  • sich an Diskussionen im Diskussionsforum beteiligen

Dennoch können sie leider nicht:

  • neue Projekte anlegen
  • merge-Requests stellen
  • Projekte forken

Um Code zu einem Projekt beitragen zu können, müssen von einem Mitlieder der öffentlichen Verwaltung zu einem Projekt oder einer Gruppe hinzugefügt werden. Falls sie also ein Dienstleister im Auftrag des öffentlichen Dienstes sind, müssen sie sich hierzu an ihren Auftraggeber des öffentlichen Dienstes wenden.

Wie kann ich überprüfen, ob meine E-Mail der öffentlichen Verwaltung zugeordnet wurde?

Hierfür können sie hier die nach der Domain ihrer E-Mail-Adresse ("der Teil hinter dem @-Zeichen") in unserer Whitelist suchen.

Falls sie keinen Eintrag zu ihrer Domain finden, sie aber dennoch der öffentlichen Verwaltung angehören, melden sie sich gerne bei uns per E-Mail unter info@opencode.de.

Woran liegt es, dass ich keine neuen Projekte anlegen kann?

  • Falls sie der öffentlichen Verwaltung angehören und dennoch keine Projekte anlegen können, dann kann es sein, dass wir ihre E-Mail-Domain nicht in unserer Liste der freigeschalteten Domains aufgenommen haben. Wenden sie sich hierfür am besten an uns per Mail über info@opencode.de.
  • Falls sie nicht der öffentlichen Verwaltung angehören und dennoch zu einem Projekt beitragen wollen, dann können sie sich von einem Account der öffentlichen Verwaltung zu einem Projekt (auch unter ihrer nicht freigeschalteten Domain) hinzugefügen lassen.