1Passwordin suojaaminen XFA:lla
Lisää laitetarkistus 1Passwordin Unlock with SSO -toimintoon, jotta vain XFA-käytäntösi läpäisevät laitteet voivat avata 1Passwordin lukituksen Googlella tai muulla OpenID Connect -identiteetintarjoajalla.
Miten se toimii
Kun joku avaa 1Passwordin lukituksen kertakirjautumisella, 1Password ohjaa hänet XFA:han. XFA tarkistaa, läpäiseekö hänen laitteensa käytäntösi, ja ohjaa hänet sitten identiteetintarjoajallesi kirjautumaan. Kirjautumisen jälkeen hän palaa 1Passwordiin, jonka lukitus avautuu. 1Password saa identiteetintarjoajaltasi saman kirjautumistuloksen, jonka se saisi ilman XFA:ta. XFA lukee tuloksesta vain käyttäjän sähköpostiosoitteen tietääkseen, kenen laitteen se tarkisti.
Huomaa: tämä artikkeli olettaa, että organisaatiollasi on XFA-tili ja että olet siinä organisaatiossa järjestelmänvalvoja. Jos sinulla ei ole tiliä, voit luoda sellaisen osoitteessa https://dashboard.xfa.tech/signup.
Ennen kuin aloitat
- 1Password Business -tili ja siinä omistajan tai järjestelmänvalvojan rooli
- Järjestelmänvalvojan pääsy identiteetintarjoajaasi
- Järjestelmänvalvojan rooli XFA:ssa
- Laitteen hyväksyntä monivaiheista todennusta varten pois päältä XFA:ssa (Vaadi laitteen hyväksyntä monivaiheista todennusta varten, kohdassa Yhteydet > Asetukset). Jos organisaatiosi vaatii sitä, et voi vielä käyttää XFA:ta 1Passwordin kanssa: XFA hylkää kirjautumisen.
Identiteetintarjoajasi täytyy:
- lisätä käyttäjän sähköpostiosoite ID-tunnukseen;
- tukea PKCE:tä (S256), jos käytät Public Clientia (asiakasta ilman asiakassalaisuutta);
- käyttää yhtä kiinteää issuer-osoitetta: identiteetintarjoajasi osoitetta, jonka annat 1Passwordille kenttään Issuer ja joka on sama kaikissa organisaatiosi kirjautumisissa (Microsoft Entra ID:ssä käytä vuokraajasi omaa issueria, älä
common-osoitetta).
Google täyttää kaikki nämä. Myös mitä tahansa muuta tarjoajaa, joka täyttää ne, voi käyttää.
1Passwordin omat Unlock with SSO -säännöt ovat voimassa:
- Owners-ryhmän jäsenet eivät koskaan avaa lukitusta SSO:lla. He avaavat lukituksen tilinsä salasanalla ja Secret Key -avaimella.
- 1Password hyväksyy Unlock with SSO -toimintoon vain yhden identiteetintarjoajan.
- 1Password tallentaa määrityksen vasta onnistuneen Test Connection -testin jälkeen.
Mihin kukin arvo menee
- XFA redirect URI: XFA:sta identiteetintarjoajallesi
- Authorization Endpoint ja Token Endpoint: XFA:n omat, XFA:sta 1Passwordiin
- Issuer ja User Info Endpoint: identiteetintarjoajasi omat, 1Passwordiin
- Client ID (ja asiakassalaisuus): identiteetintarjoajaltasi 1Passwordiin
- Discovery-URL: identiteetintarjoajaltasi XFA:han (XFA:n vaihe 1, vain Muu)
1Password-sovelluksen luominen XFA:ssa
- Siirry XFA:n hallintapaneelissa kohtaan Integraatiot, napsauta 1Password-kortissa Ota käyttöön ja sitten osiossa Kirjautumistarkistukset Ota käyttöön. XFA avaa sivun Suojaa 1Password XFA:lla.
- Anna Perustiedot-kortissa Nimi. Valitse kohdassa Käytäntö XFA-käytäntö, jonka laitetarkistuksia haluat käyttää lukituksen avaamisessa.
- Syötä XFA:n vaiheessa 1 (Kerro XFA:lle 1Password-tilistäsi) kenttään 1Password-kirjautumisosoitteesi osoite, jossa avaat 1Passwordin, esimerkiksi
team-acme.1password.com. XFA täyttää 1Passwordin omat kaksi uudelleenohjausosoitetta (redirect URI): toisen selainta ja toisen 1Password-sovelluksia varten. Niille ei tarvitse tehdä mitään. Myöhemmin kopioit XFA redirect URI -arvon vaiheesta 2. - Valitse kohdassa Identiteetintarjoaja tarjoajasi. Tämä valinta tehdään vain XFA:ssa. 1Passwordissa valitset aina Other ja sitten Manual.
- Google: XFA täyttää Googlen tiedot.
- Muu, kaikille muille tarjoajille: liitä osoite kenttään Identiteetintarjoajasi discovery-URL (se päättyy /.well-known/openid-configuration) ja napsauta Täytä.
- Napsauta Tallenna ja jatka myöhemmin. Tämä tallentaa vaiheen 1.
- XFA:n vaiheessa 2 näkyy XFA redirect URI kohdassa Identiteetintarjoajallesi. XFA:n vaiheessa 3 kohdassa 1Passwordiin näkyvät XFA:n Token Endpoint ja Authorization Endpoint.
Identiteetintarjoajan määrittäminen
Tarvitset identiteetintarjoajaasi OAuth-asiakkaan (jotkin tarjoajat kutsuvat sitä sovellukseksi tai app integrationiksi) 1Passwordia varten. Jos tiimisi jo avaa 1Passwordin lukituksen SSO:lla, voit käyttää samaa asiakasta edelleen. Jos ei, luo se 1Passwordin tarjoajakohtaisella oppaalla. Kun opas siirtyy 1Passwordin määrittämiseen, noudata sen sijaan kohtaa Unlock with SSO -toiminnon määrittäminen 1Passwordissa.
Kaikilla tarjoajilla tärkein muutos on XFA redirect URI, joka lisätään ylimääräiseksi sallituksi uudelleenohjausosoitteeksi. Älä poista siellä jo olevia 1Passwordin uudelleenohjausosoitteita. Jokaisen tarjoajan täytyy myös lisätä käyttäjän sähköpostiosoite ID-tunnukseen (Ennen kuin aloitat). Kun olet valmis, kopioi Client ID ja asiakassalaisuus, jos sellainen on: ne tulevat 1Passwordiin, eivät XFA:han. Napsauta sitten XFA:n vaiheessa 2 Merkitse valmiiksi.
1Passwordin opas: Configure Unlock 1Password with Google. Asiakas on tyyppiä Web application.
- Avaa Google Cloud -konsolissa APIs & Services > Clients ja valitse asiakas.
- Napsauta kohdassa Authorized redirect URIs Add URI, liitä XFA redirect URI ja napsauta Save.
- Avaa OAuth consent screen ja sitten Branding. Lisää kohtaan Authorized domains
xfa.techverkkotunnuksen1password.comrinnalle ja napsauta Save. - Kopioi Client ID ja Client secret. Google antaa aina asiakassalaisuuden.
Googlen mukaan muutosten käyttöönotto voi kestää 5 minuutista muutamaan tuntiin.
1Passwordissa: Issuer https://accounts.google.com, User Info Endpoint https://openidconnect.googleapis.com/v1/userinfo, Client Type Private Client ja asiakassalaisuus.
Microsoft Entra ID
1Passwordin opas: Configure Unlock 1Password with Microsoft Entra ID.
- Avaa 1Passwordin sovelluksen rekisteröinnissä Authentication. Lisää Web-alustan alle XFA redirect URI ja napsauta Save.
- Napsauta kohdassa Token configuration Add optional claim, valitse ID ja valitse email, jotta ID-tunnus sisältää sähköpostiosoitteen.
- Kopioi Application (client) ID ja asiakassalaisuuden arvo.
Discovery-URL on OpenID Connect metadata document kohdassa Overview > Endpoints. Se sisältää vuokraajasi tunnuksen: https://login.microsoftonline.com/<your-tenant-id>/v2.0/.well-known/openid-configuration.
1Passwordissa: Issuer https://login.microsoftonline.com/<your-tenant-id>/v2.0, User Info Endpoint https://graph.microsoft.com/oidc/userinfo, Client Type Private Client ja asiakassalaisuus. Valitse Public Client vain, jos lisäsit XFA redirect URI:n Mobile and desktop applications -alustan alle Web-alustan sijaan.
Okta
1Passwordin opas: Configure Unlock 1Password with Okta.
-
Lisää 1Passwordin Okta-sovelluksessa XFA redirect URI kohtaan Sign-in redirect URIs ja napsauta Save.
Okta-katalogin 1Password-sovellus ei välttämättä anna lisätä uudelleenohjausosoitetta. Luo silloin sen sijaan oma sovellus: Applications > Create App Integration > OIDC - OpenID Connect > Web Application. Lisää XFA redirect URI kohtaan Sign-in redirect URIs.
-
Kopioi Client ID ja asiakassalaisuus, jos sellainen on.
Discovery-URL on https://<your-okta-domain>/.well-known/openid-configuration.
1Passwordissa: avaa discovery-URL selaimessasi. Issuer on sen issuer-arvo ja User Info Endpoint sen userinfo_endpoint-arvo. Client Type: Private Client ja Web Application -sovelluksen asiakassalaisuus. Valitse Public Client vain Native Application- tai Single-Page Application -sovelluksella, jonka asiakkaan todennus on None ja joka vaatii PKCE:n.
Auth0
1Passwordin opas: Configure Unlock 1Password with Auth0.
- Lisää 1Passwordin Auth0-sovelluksessa XFA redirect URI kohtaan Allowed Callback URLs. Erota se siellä jo olevista URL-osoitteista pilkulla. Napsauta Save Changes.
- Kopioi Client ID ja Client Secret, jos sovelluksella sellainen on.
Discovery-URL on https://<your-domain>.auth0.com/.well-known/openid-configuration.
1Passwordissa: avaa discovery-URL selaimessasi. Issuer on sen issuer-arvo ja User Info Endpoint sen userinfo_endpoint-arvo. Client Type: Private Client, jos sovelluksella on asiakassalaisuus, muuten Public Client.
JumpCloud
1Passwordin opas: Configure Unlock 1Password with JumpCloud.
- Lisää 1Passwordin JumpCloud OIDC -sovelluksessa SSO-välilehdellä XFA redirect URI kohtaan Redirect URIs ja tallenna.
- Kopioi Client ID ja asiakassalaisuus, jos sovelluksella sellainen on.
Discovery-URL on https://oauth.id.jumpcloud.com/.well-known/openid-configuration, tai EU-tilillä https://oauth.id.eu.jumpcloud.com/.well-known/openid-configuration.
1Passwordissa: avaa discovery-URL selaimessasi. Issuer on sen issuer-arvo ja User Info Endpoint sen userinfo_endpoint-arvo. Client Type: Private Client, jos sovelluksella on asiakassalaisuus, muuten Public Client.
Muut OpenID Connect -tarjoajat
1Passwordin opas: Configure Unlock 1Password with other identity providers. Käytä tätä osiota, jos tarjoajasi on Duo, OneLogin, Ping Identity tai jokin muu OpenID Connect -tarjoaja.
- Lisää tarjoajasi 1Passwordia varten luodussa OpenID Connect -sovelluksessa XFA redirect URI sallittuihin uudelleenohjausosoitteisiin.
- Tarkista, että tarjoaja lisää sähköpostiosoitteen ID-tunnukseen. Jotkin tarjoajat tarvitsevat tähän asetuksen tai väitteen yhdistämisen (claim mapping).
- Kopioi Client ID ja asiakassalaisuus, jos sovelluksella sellainen on.
Discovery-URL löytyy tarjoajasi ohjeista.
1Passwordissa: avaa discovery-URL selaimessasi. Issuer on sen issuer-arvo ja User Info Endpoint sen userinfo_endpoint-arvo. Client Type: Private Client, jos sovelluksella on asiakassalaisuus, muuten Public Client.
Unlock with SSO -toiminnon määrittäminen 1Passwordissa
- Kirjaudu 1Password-tiliisi osoitteessa 1Password.com ja valitse sivupalkista Policies.
- Valitse kohdassa Single sign-on Manage policies.
- Valitse Other, vaikka käyttäisit Googlea, ja sitten Manual, niin voit antaa jokaisen arvon itse. 1Passwordin täytyy puhua ensin XFA:n kanssa. 1Passwordin Google-vaihtoehto ohittaisi XFA:n.
- Täytä kentät:
- Client ID: identiteetintarjoajaltasi
- Issuer: identiteetintarjoajasi oma
- Token Endpoint: XFA:n oma
- Authorization Endpoint: XFA:n oma
- User Info Endpoint: identiteetintarjoajasi oma
- Client Type: kuten tarjoajasi osiossa sanotaan. 1Password merkitsee Public Client -vaihtoehdon suositelluksi; älä välitä siitä merkinnästä. Valitse Private Client, jos tarjoajasi antoi sinulle asiakassalaisuuden (Google antaa aina), ja liitä se kenttään Client secret (value). Valitse Public Client vain, jos salaisuutta ei ole.
- Valitse Next. 1Password näyttää uudelleenohjausosoitteensa. Sinun ei tarvitse kopioida niitä. XFA täytti ne kirjautumisosoitteesi perusteella.
- Palaa XFA:han ja napsauta XFA:n vaiheessa 3 Merkitse valmiiksi.
- Valitse 1Passwordissa Next ja sitten Test Connection. 1Password avaa XFA:n, joka tarkistaa käyttämäsi laitteen ja ohjaa sinut identiteetintarjoajallesi kirjautumaan. Jos laitteesi ei läpäise jotakin tarkistusta, XFA näyttää, mitä pitää korjata. Korjaa se ja suorita Test Connection uudelleen. Test Connection ei tallenna mitään, joten muille ei vielä muutu mitään.
- Kun testi onnistuu, valitse Save. Tallentaminen korvaa nykyisen SSO-määrityksesi: siitä alkaen jokainen, joka avaa 1Passwordin lukituksen SSO:lla, kulkee XFA:n laitetarkistuksen kautta.
- Valitse kohdassa People unlocking 1Password with an identity provider, ketkä avaavat lukituksen SSO:lla. Aloita valinnalla Only groups you select ja pienellä testiryhmällä, ja laajenna sitä, kun lukituksen avaaminen toimii heillä. Kun käyttäjät siirtyvät SSO:hon, 1Password pyytää heiltä kerran tilin salasanan ja Secret Key -avaimen.
- Palaa XFA:han ja napsauta XFA:n vaiheessa 4 (Testaa yhteys) Merkitse valmiiksi. Napsauta sitten Viimeistele käyttöönotto.
Mitä käyttäjät näkevät
XFA tarkistaa laitteen aina, kun 1Password pyytää käyttäjää kirjautumaan SSO:lla, sekä selaimessa että 1Password-sovelluksissa:
- Selaimessa 1Password ohjaa käyttäjän XFA:han, sitten identiteetintarjoajalle ja takaisin 1Passwordiin.
- 1Passwordin työpöytäsovelluksessa selain avautuu laitetarkistusta ja kirjautumista varten. Kun laitetarkistus ja kirjautuminen on tehty, selain pyytää avaamaan 1Passwordin, ja sovelluksen lukitus avautuu.
Jos laite ei läpäise käytäntöä, XFA näyttää, mikä tarkistus epäonnistuu ja miten sen voi korjata. Jos käytäntösi estää jatkamisen tarkistuksen epäonnistuessa, lukituksen avaaminen keskeytyy. Jos se vain varoittaa, käyttäjä voi jatkaa. Näet käytännöstä XFA:n Käytännöt-kohdassa, estääkö vai varoittaako tarkistus.
XFA ei tarkista laitetta, kun:
- käyttäjä avaa lukituksen biometriikalla (Touch ID, Windows Hello, kasvojentunnistus), koska se ei kulje SSO:n kautta;
- käyttäjä kuuluu 1Passwordin Owners-ryhmään;
- käyttäjä ei kuulu ryhmään, joka avaa lukituksen SSO:lla.
Yhteyden testaaminen
Kuka tahansa järjestelmänvalvoja voi suorittaa Test Connection -testin, myös omistajat: se testaa yhteyden, ei heidän omaa lukituksen avaamistaan. Käytä itse lukituksen avaamisen testaamiseen jäsentä, joka ei ole omistaja: omistajat eivät koskaan käytä SSO:ta, joten heidän lukituksensa avaaminen ei kulje XFA:n kautta. Lisää tämä jäsen testiryhmään. Lukitse 1Password ja avaa sen lukitus SSO:lla sekä selaimessa että työpöytäsovelluksessa. Jäsenen pitäisi kulkea XFA:n laitetarkistuksen ja identiteetintarjoajasi kautta ennen kuin 1Passwordin lukitus avautuu.
Vianmääritys
Identiteetintarjoaja hylkää uudelleenohjausosoitteen
Google näyttää virheen redirect_uri_mismatch, kun XFA redirect URI ei ole asiakkaan kohdassa Authorized redirect URIs; muut tarjoajat näyttävät samankaltaisen virheen. Kopioi se uudelleen XFA:sta Kopioi-painikkeella, jotta se vastaa täsmälleen. Se on muotoa https://device-api.xfa.tech/<application-id>/oauth2/redirect.
Jos XFA hylkää uudelleenohjauksen, XFA:han annettu 1Passwordin kirjautumisosoite ei vastaa 1Password-tiliäsi. Korjaa se XFA:n vaiheessa 1. Käytä osoitetta, joka näkyy selaimesi osoiterivillä, kun käytät 1Passwordia.
Test Connection epäonnistuu
- 1Passwordin Authorization Endpoint ja Token Endpoint ovat XFA:n. Issuer ja User Info Endpoint ovat identiteetintarjoajasi.
- 1Passwordin Client ID, Client Type ja asiakassalaisuus vastaavat identiteetintarjoajasi asiakasta. Jos ne eivät vastaa, tarjoajasi näyttää virheen
invalid_client. - Laite, jolla testaat, läpäisee valitsemasi XFA-käytännön.
- Sähköpostiosoitteesi identiteetintarjoajassa on sama kuin sähköpostiosoitteesi 1Passwordissa.
Test Connection epäonnistuu virheellä invalid_scope
XFA keskeyttää kirjautumisen virheellä invalid_scope, kun identiteetintarjoajasi ID-tunnuksessa ei ole sähköpostiosoitetta. Määritä tarjoajasi lisäämään sähköpostiosoite ID-tunnukseen: Microsoft Entra ID:ssä lisää valinnainen email-väite (katso Microsoft Entra ID).
Laite ei läpäise käytäntöä
XFA näyttää käyttäjälle, mikä tarkistus epäonnistuu ja miten sen voi korjata. Korjauksen jälkeen hän avaa 1Passwordin lukituksen uudelleen. Jos haluat muuttaa sovellettavia tarkistuksia, muokkaa käytäntöä, joka on liitetty XFA:n 1Password-sovellukseen.