Nitrokey-asetusten määrittäminen Entra ID:lle

Compatible Nitrokeys

3A/C/Mini

Passkey

HSM 2

Pro 2

FIDO2

Storage 2

Start

U2F

active

active

inactive

inactive

inactive

inactive

inactive

inactive

Nitrokey 3 ja Nitrokey Passkey tukevat Microsoft Entra -tunnistetietojen määrittämistä, mikä mahdollistaa työntekijöiden saumattoman perehdyttämisen yrityskäyttötilanteissa.

Setup

Käyttäjätunnusten ohjelmoitu rekisteröinti edellyttää Microsoft Entra -sovellusta. Tässä oppaassa annetaan ohjeet sovelluksen määrittämiseen, edellyttäen että sinulla on siihen tarvittavat käyttöoikeudet.

  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. Valitse ”Uusi rekisteröinti”.

    App registration
  3. Luo uusi sovellus ja anna sille nimi. Napsauta ”Rekisteröi”.

    App registration
  4. Kirjoita tähän muistiin asiakastunnus (Client ID) ja vuokralais-ID (Tenant ID). Tarvitset niitä myöhemmin. Siirry sovelluksen välilehdellä kohtaan ”API-käyttöoikeudet”.

    App home
  5. Click on Add a permission.

    App home
  6. Select Microsoft Graph.

    App home
  7. Valitse Sovelluksen käyttöoikeudet.

    App home
  8. Etsi UserAuthenticationMethod.ReadWrite.All ja valitse se.

    App home
  9. Etsi User.ReadWrite.All ja valitse se (vain jos haluat pystyä luomaan käyttäjiä pynitrokey-sovelluksen avulla). Napsauta Lisää käyttöoikeudet -painiketta.

    App home
  10. Tarkista myönnetyt käyttöoikeudet.

    App home
  11. Napsauta kohtaa ”Myönnä järjestelmänvalvojan suostumus” ja hyväksy se.

    App home
  12. Palaa sovelluksen aloitussivulle ja valitse vasemmanpuoleisesta valikosta ”Sertifikaatit ja salaisuudet”

    App home
  13. Napsauta ”Uusi asiakassalaisuus”

    App home
  14. Syötä nimi ja voimassaoloaika ja napsauta sitten Lisää-painiketta

    App home
  15. Kirjoita asiakassalaisuus muistiin (et voi tarkastella sitä myöhemmin).

    App home
  16. Napsauta vasemmalla olevasta valikosta kohtaa ”Todentamismenetelmät”.

    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. Poista valinta kohdasta ”Enforce Attestation” (vain jos käytät Nitrokey-avainta, jolla ei ole FIDO Alliance -sertifiointia. Tämän ohjeen kirjoittamishetkellä vain Nitrokey 3A Mini -mallilla on kyseinen sertifiointi.)

    App home
  21. Click Save.

    App home
  22. Olet merkinnyt muistiin vuokralaisen tunnuksen (Tenant ID), asiakastunnuksen (Client ID), asiakassalaisuuden (Client Secret) ja ensisijaisen verkkotunnuksen (Primary Domain) osana prosessia. Luo config.json-tiedosto, johon kirjaat nämä tiedot. Alla on esimerkki tiedostosta.

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

Käyttö

Voit käyttää pynitrokey-apuohjelmaa Nitrokey-laitteen käyttöönottamiseen vuokralaisesi käyttäjälle.

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

Tässä <username> voi olla käyttäjän sähköpostiosoite (Microsoftin terminologiassa ”User principal”) tai sen osa ennen @-merkkiä. –create-user-lippu ohjeistaa työkalua luomaan käyttäjän, jos tätä ei vielä ole Entra-vuokralaisessa.

App home

Verification

Käyttäjä voi kirjautua Microsoft-tiliinsä äskettäin käyttöönotetulla Nitrokey-avaimella. Seuraa ohjeita osoitteessa . Katso esimerkki Microsoft-kirjautumisesta Nitrokey-avaimella osoitteessa, jossa kerrotaan, miten kirjaudutaan sisään tällä äskettäin käyttöönotetulla Nitrokey-avaimella.

Voit tarkistaa varatut tunnistetiedot Entra-hallintaportaalista seuraamalla näitä ohjeita.

  1. Siirry Entra-hallintakeskuksen vasemmalla olevasta palkista Käyttäjät-kohtaan.

    alt
  2. Jos käyttäjä on luotu –create-user-parametrilla, saatat löytää hänet luettelosta. Jos kyseessä on jo olemassa oleva käyttäjä, hänkin löytyy sieltä. Napsauta sitä käyttäjää, jolle tunnistetiedot on rekisteröity.

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

    alt
  4. Näkyvissä on rekisteröity tunnistetieto, jonka alussa on Nitrokey-UUID:n viisi ensimmäistä merkkiä. Voit napsauttaa kolmea pistettä ja valita sitten ”Näytä tiedot”, jolloin saat näkyviin rekisteröidyn tunnistetiedon yksityiskohtaiset tiedot.

    alt
  5. Tunnuksesta näkyisi lisätietoja. Voit tarkistaa ne.

    alt