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:
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
- Auf dieser Seite (siehe Screenshot) können sie sich für die Nutzung von openCode registrieren.
- Sie müssen hier alle Felder ausfüllen sowie den Nutzungsbedingungen und der Datenschutzerklärung zustimmen.
- Für eine Nutzung von openCode ist es 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.
- Nachdem sie auf "Jetzt Registrieren" gedrückt haben, müssen sie die Registrierung noch per E-Mail bestätigen. Klicken sie hierfür in der entsprechenden E-Mail auf "Jetzt Verifizieren".
- Fahren sie nun fort mit den Schritten zur Einrichtung der Zwei-Faktor-Authentifizierung
Es ist wichtig zu berücksichtigen, dass für die Nutzung des vollständigen Funktionsumfangs ihre E-Mail-Adresse der Öffentlichen Verwaltung angehören muss.
Ob ihre E-Mail-Adresse auf openCode der Öffentlichen Verwaltung zugeordnet wurde, können Sie auf dieser Webseite überprüfen. Ansonsten können Sie sich, bei einem Fehlen Ihrer Domain, auch per E-Mail an info@opencode.de wenden.
2. Einrichtung der Zwei-Faktor-Authentifizierung
Nachdem sie das Registierungsformular ausgefüllt haben und ihre E-Mail-Adresse verifiziert haben, werden sie nun zur Einrichtung der Zwei-Faktor-Authentifizierung (2FA) weitergeleitet (siehe Screenshot).
Befolgen sie nun folgende Schritte um diese erfolgreich einzurichten:
- Installation einer Authentificator-App (z.B. FreeOTP) auf einem zweiten Gerät, wie z.B. einem Smartphone
-
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:
- 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:
- 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:
- Ü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:
- FreeOTP
- Google Authenticator
- Microsoft Authenticator
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-Reqeusts 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.
Created: January 22, 2025