Διαμόρφωση Nitrokey για το Entra ID

Compatible Nitrokeys

3A/C/Mini

Passkey

HSM 2

Pro 2

FIDO2

Storage 2

Start

U2F

✓

active

✓

active

⨯

inactive

⨯

inactive

⨯

inactive

⨯

inactive

⨯

inactive

⨯

inactive

The Nitrokey 3 and Nitrokey Passkey support provisioning credentials for Microsoft Entra for seamless employee on-boarding in enterprise scenarios.

Ρύθμιση

Απαιτείται μια εφαρμογή Microsoft Entra για να είναι δυνατή η προγραμματισμένη καταχώριση των διαπιστευτηρίων των χρηστών. Εδώ σας παρέχουμε τον οδηγό για τη ρύθμιση της εφαρμογής, υπό την προϋπόθεση ότι διαθέτετε τα κατάλληλα δικαιώματα για τον σκοπό αυτό.

  1. Login to Entra Admin portal. Take a note of the primary domain which you will need later. Go to App Registrations on the left blade.

    Entra Admin Portal
  2. Επιλέξτε «Νέα εγγραφή».

    App registration
  3. Δημιουργήστε μια νέα εφαρμογή και ορίστε ένα όνομα. Κάντε κλικ στο «Εγγραφή».

    App registration
  4. Σημειώστε εδώ το Client ID και το Tenant ID. Θα τα χρειαστείτε αργότερα. Μεταβείτε στην ενότητα «API Permissions» (Άδειες API) στο παράθυρο της εφαρμογής.

    App home
  5. Click on Add a permission.

    App home
  6. Select Microsoft Graph.

    App home
  7. Επιλέξτε «Άδειες εφαρμογής».

    App home
  8. Search for UserAuthenticationMethod.ReadWrite.All and select it.

    App home
  9. Search for User.ReadWrite.All and select it (Only if you want to be able to create users from pynitrokey). Click on the Add Permissions button.

    App home
  10. Ελέγξτε τα δικαιώματα που έχουν χορηγηθεί.

    App home
  11. Κάντε κλικ στην επιλογή «Χορήγηση συγκατάθεσης διαχειριστή» και εγκρίνετέ την.

    App home
  12. Επιστρέψτε στην αρχική οθόνη της εφαρμογής και επιλέξτε «Πιστοποιητικά και μυστικά» από το αριστερό πλαίσιο

    App home
  13. Κάντε κλικ στην επιλογή «Νέο μυστικό πελάτη»

    App home
  14. Εισάγετε ένα όνομα και ημερομηνία λήξης και, στη συνέχεια, κάντε κλικ στο κουμπί «Προσθήκη»

    App home
  15. Σημειώστε το Client Secret (Δεν θα μπορείτε να το δείτε αργότερα.)

    App home
  16. Κάντε κλικ στην επιλογή «Μέθοδοι πιστοποίησης» στο αριστερό πλαίσιο.

    App home
  17. Select Passkey (FIDO2).

    App home
  18. Click on the Configure tab.

    App home
  19. Click on Default Passkey profile

    App home
  20. Αποεπιλέξτε το πλαίσιο «Επιβολή πιστοποίησης» (Μόνο αν χρησιμοποιείτε Nitrokey που δεν διαθέτει πιστοποίηση της FIDO Alliance. Κατά τη στιγμή της σύνταξης του παρόντος εγγράφου, μόνο το Nitrokey 3A Mini διαθέτει αυτή την πιστοποίηση.)

    App home
  21. Click Save.

    App home
  22. You have taken note of the Tenant ID, Client ID, Client Secret and Primary Domain as a part of the process. Make a config.json file with the information. An example is shown below.

    {
        "tenant": "49d2c4c8-9144-49ea-b5f3-fc11b848cd72",
        "client": "e9f25c9c-3870-4aa8-9659-a40f09de093e",
        "secret": "************************************",
        "domain": "Cryptane.onmicrosoft.com"
    }
    

Χρήση

You may use the pynitrokey utility to provision a Nitrokey for an user in your tenant.

nitropy fido2 provision-credential entra -c config.json <username> --create-user

Here the <username> could be the Email ID of the user (User principal in terms of Microsoft) or a part of it till before the @ sign. The --create-user flag directs the tool to create the user if it does not exist in the Entra Tenant.

$ nitropy fido2 provision-credential entra -c config.json aditya --create-user
Command line tool to interact with Nitrokey devices 0.12.3
Warning: It is recommended to execute nitropy with admin privileges to be able to access Nitrokey 3 and Nitrokey FIDO 2 devices.
Waiting 5 secs for Graph API to update
User aditya created on Entra
Enter PIN:
Touch your authenticator device now...
Entra credential for aditya pre-registered on NK3 A56F0 with Credential ID owBYLNXsrDZ104I2MyCtuxmXKAd0Um56t3Byx5VfMz-Vs1Azy1re4Rdf-foMsc7vAUw7lJgCoG1VSdl2mBoCUHWGpTH-YkjEJ4UC4YlIEdk1.

Verification

Ο χρήστης μπορεί να χρησιμοποιήσει το Nitrokey που μόλις ενεργοποιήθηκε για να συνδεθεί στον λογαριασμό του στη Microsoft. Ακολουθήστε τον σύνδεσμο Παράδειγμα σύνδεσης στη Microsoft με το Nitrokey για να συνδεθείτε με αυτό το Nitrokey που μόλις ενεργοποιήθηκε.

Μπορείτε να επαληθεύσετε τα διαπιστευτήρια που έχουν εκδοθεί από την πύλη διαχείρισης της Entra, ακολουθώντας τα παρακάτω βήματα.

  1. Μεταβείτε στην επιλογή «Χρήστες» από την αριστερή στήλη στο Κέντρο διαχείρισης Entra.

    alt
  2. If the user was created with the --create-user flag you may be able to find the entry on the list. If it is a pre-existing user, it would also be there. Click on the user to which the credential was enrolled.

    alt
  3. Click on Authentication methods on the user blade.

    alt
  4. Θα εμφανίζονται τα καταχωρημένα διαπιστευτήρια με τους πρώτους 5 χαρακτήρες του UUID του Nitrokey. Μπορείτε να κάνετε κλικ στις τρεις τελείες και στη συνέχεια στην επιλογή «Προβολή λεπτομερειών» για να δείτε αναλυτικές πληροφορίες σχετικά με τα καταχωρημένα διαπιστευτήρια.

    alt
  5. Θα εμφανίζονται πρόσθετες πληροφορίες σχετικά με το πιστοποιητικό. Μπορείτε να τις επαληθεύσετε.

    alt