„Nitrokey“ konfigūravimas „Entra ID“ sistemai

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.

Sąranka

Norint programiškai registruoti vartotojo prisijungimo duomenis, reikalinga „Microsoft Entra“ programa. Čia pateikiame jos nustatymo instrukciją, jei turite atitinkamas teises tai atlikti.

  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. Pasirinkite „Nauja registracija“.

    App registration
  3. Sukurkite naują programėlę ir nurodykite jos pavadinimą. Spustelėkite „Registruotis“.

    App registration
  4. Čia užsirašykite kliento ID ir nuomininko ID. Jie jums prireiks vėliau. Aplikacijos skirtuke eikite į „API leidimai“.

    App home
  5. Click on Add a permission.

    App home
  6. Select Microsoft Graph.

    App home
  7. Pasirinkite „Programos leidimai“.

    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. Patikrinkite suteiktus leidimus.

    App home
  11. Spustelėkite „Suteikti administratoriaus sutikimą“ ir patvirtinkite jį.

    App home
  12. Grįžkite į programėlės pagrindinį ekraną ir kairiajame meniu pasirinkite „Sertifikatai ir slaptažodžiai“

    App home
  13. Spustelėkite „Naujas kliento slaptasis raktas“

    App home
  14. Įveskite pavadinimą ir galiojimo pabaigos datą, tada spustelėkite „Pridėti“

    App home
  15. Užsirašykite kliento slaptažodį (vėliau jo nebegalėsite peržiūrėti).

    App home
  16. Kairiajame skydelyje spustelėkite „Autentifikavimo metodai“.

    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. Pašalinkite žymę iš laukelio „Priversti patvirtinti“ (tik jei naudojate „Nitrokey“, neturintį FIDO Alliance sertifikato. Šio dokumento rengimo metu šį sertifikatą turi tik „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"
    }
    

Naudojimas

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

Vartotojas gali naudoti naujai parengtą „Nitrokey“ prisijungti prie savo „Microsoft“ paskyros. Sekite nuorodą Pavyzdinis prisijungimas prie „Microsoft“ naudojant „Nitrokey“, norėdami prisijungti su šiuo naujai parengtu „Nitrokey“.

Galite patikrinti suteiktus prisijungimo duomenis „Entra“ administratorių portale, atlikdami toliau nurodytus veiksmus.

  1. „Entra“ administravimo centro kairiajame skydelyje pereikite prie parinkties „Vartotojai“.

    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. Bus rodomas užregistruotas prisijungimo duomenų rinkinys su pirmais 5 „Nitrokey“ UUID simboliais. Norėdami peržiūrėti išsamią informaciją apie užregistruotą prisijungimo duomenų rinkinį, spustelėkite tris taškelius ir tada pasirinkite „Peržiūrėti išsamią informaciją“.

    alt
  5. Bus rodomi papildomi duomenys apie šį tapatybės patvirtinimą. Juos galite patikrinti.

    alt