Ga naar hoofdinhoud

1Password1Password beveiligen met XFA

Voeg een toestelcontrole toe aan 1Password Unlock with SSO, zodat alleen toestellen die aan je XFA-beleid voldoen 1Password kunnen ontgrendelen met Google of een andere OpenID Connect identity provider.

Hoe het werkt

Wanneer iemand 1Password ontgrendelt met single sign-on, stuurt 1Password die persoon naar XFA. XFA toetst het toestel aan je beleid en stuurt de persoon daarna naar je identity provider om zich aan te melden. Na het aanmelden gaat de persoon terug naar 1Password, en 1Password ontgrendelt. 1Password krijgt van je identity provider hetzelfde aanmeldresultaat als zonder XFA. XFA leest uit dat resultaat alleen het e-mailadres van de persoon, om te weten wiens toestel het heeft gecontroleerd.

Let op: dit artikel gaat ervan uit dat je organisatie een XFA-account heeft en dat jij daar beheerder van bent. Heb je nog geen account, dan kun je er een aanmaken op https://dashboard.xfa.tech/signup.

Voordat je begint

  • Een 1Password Business-account, met een rol als eigenaar of beheerder daarin
  • Beheerderstoegang tot je identity provider
  • Een beheerdersrol in XFA
  • Toestelgoedkeuring voor multifactorauthenticatie uitgeschakeld in XFA (Toestelgoedkeuring vereisen voor multifactorauthenticatie, onder Connecties > Instellingen). Vereist jouw organisatie toestelgoedkeuring, dan kun je XFA nog niet met 1Password gebruiken: XFA weigert de aanmelding.

Je identity provider moet:

  • het e-mailadres van de persoon in het ID-token zetten;
  • PKCE (S256) ondersteunen, als je een Public Client gebruikt (een zonder client secret);
  • één vast issuer-adres hebben: het adres van je identity provider dat je aan 1Password geeft als Issuer, hetzelfde voor elke aanmelding in je organisatie (gebruik voor Microsoft Entra ID de eigen issuer van je tenant, niet de common-issuer).

Google voldoet aan al deze eisen. Elke andere provider die eraan voldoet, kun je ook gebruiken.

De eigen regels van 1Password voor Unlock with SSO gelden:

  • Leden van de groep Owners ontgrendelen nooit met SSO. Zij ontgrendelen met hun accountwachtwoord en Secret Key.
  • 1Password accepteert maar één identity provider voor Unlock with SSO.
  • 1Password slaat een configuratie pas op na een geslaagde Test Connection.

Waar elke waarde naartoe gaat

  • XFA redirect URI: van XFA naar je identity provider
  • Authorization Endpoint en Token Endpoint: die van XFA, van XFA naar 1Password
  • Issuer en User Info Endpoint: die van je identity provider, naar 1Password
  • Client ID (en client secret): van je identity provider naar 1Password
  • Discovery-URL: van je identity provider naar XFA (stap 1 in XFA, alleen bij Andere)

De 1Password-applicatie aanmaken in XFA

  1. Ga in het XFA-dashboard naar Integraties en klik op de kaart 1Password op Instellen en daarna in het onderdeel Aanmeldcontroles op Instellen. XFA opent Beveilig 1Password met XFA.
  2. Vul in de kaart Basisgegevens onder Naam een naam in. Kies onder Policy het XFA-beleid met de toestelcontroles die je wilt bij het ontgrendelen.
  3. Vul in stap 1 in XFA, Vertel XFA over je 1Password-account, het veld Je aanmeldadres van 1Password in: het adres waarop je 1Password opent, bijvoorbeeld team-acme.1password.com. XFA vult de twee eigen redirect URI's van 1Password in: één voor de browser en één voor de 1Password-apps. Daar hoef je niets mee te doen. De waarde die je later kopieert, is de XFA redirect URI uit stap 2.
  4. Kies onder Identiteitsprovider je provider. Die keuze bestaat alleen in XFA. In 1Password kies je altijd Other en daarna Manual.
    • Google: XFA vult de gegevens van Google in.
    • Andere, voor elke andere provider: plak de URL in Discovery-URL van je identiteitsprovider (eindigt op /.well-known/openid-configuration) en klik op Invullen.
  5. Klik op Opslaan en later verdergaan. Daarmee is stap 1 opgeslagen.
  6. Stap 2 in XFA toont de XFA redirect URI onder Voor je identiteitsprovider. Stap 3 in XFA toont onder Voor 1Password het Token Endpoint en het Authorization Endpoint van XFA.

Je identity provider instellen

Je hebt in je identity provider een OAuth-client voor 1Password nodig (sommige providers noemen dat een applicatie of app-integratie). Ontgrendelt je team 1Password al met SSO, dan kun je die client blijven gebruiken. Zo niet, maak hem dan aan met de gids van 1Password voor je provider. Waar die gids 1Password instelt, volg je in plaats daarvan Unlock with SSO instellen in 1Password.

Bij elke provider is de belangrijkste wijziging de XFA redirect URI, als extra toegestane redirect URI. Verwijder de redirect URI's van 1Password die er al staan niet. Elke provider moet ook het e-mailadres van de persoon in het ID-token zetten (Voordat je begint). Kopieer daarna de Client ID, en het client secret als er een is: die komen in 1Password, niet in XFA. Klik dan bij stap 2 in XFA op Markeren als klaar.

Google

Gids van 1Password: Configure Unlock 1Password with Google. De client is van het type Web application.

  1. Open in de Google Cloud console APIs & Services > Clients en selecteer de client.
  2. Klik onder Authorized redirect URIs op Add URI, plak de XFA redirect URI en klik op Save.
  3. Open op het OAuth consent screen het onderdeel Branding. Voeg onder Authorized domains xfa.tech toe naast 1password.com en klik op Save.
  4. Kopieer de Client ID en het Client secret. Google geeft altijd een client secret.

Volgens Google kan een wijziging 5 minuten tot een paar uur duren.

In 1Password: Issuer https://accounts.google.com, User Info Endpoint https://openidconnect.googleapis.com/v1/userinfo, Client Type Private Client met het client secret.

Microsoft Entra ID

Gids van 1Password: Configure Unlock 1Password with Microsoft Entra ID.

  1. Open in de app-registratie voor 1Password Authentication. Voeg onder het platform Web de XFA redirect URI toe en klik op Save.
  2. Klik onder Token configuration op Add optional claim, kies ID en selecteer email, zodat het ID-token het e-mailadres bevat.
  3. Kopieer de Application (client) ID en de waarde van het client secret.

De discovery-URL is het OpenID Connect metadata document onder Overview > Endpoints. Die bevat je tenant-ID: https://login.microsoftonline.com/<your-tenant-id>/v2.0/.well-known/openid-configuration.

In 1Password: Issuer https://login.microsoftonline.com/<your-tenant-id>/v2.0, User Info Endpoint https://graph.microsoft.com/oidc/userinfo, Client Type Private Client met het client secret. Kies Public Client alleen als je de XFA redirect URI hebt toegevoegd onder het platform Mobile and desktop applications in plaats van Web.

Okta

Gids van 1Password: Configure Unlock 1Password with Okta.

  1. Voeg in de Okta-app voor 1Password de XFA redirect URI toe onder Sign-in redirect URIs en klik op Save.

    De 1Password-app uit de Okta-catalogus laat je misschien geen redirect URI toevoegen. Maak dan in plaats daarvan je eigen app aan: Applications > Create App Integration > OIDC - OpenID Connect > Web Application. Voeg de XFA redirect URI toe onder Sign-in redirect URIs.

  2. Kopieer de Client ID, en het client secret als er een is.

De discovery-URL is https://<your-okta-domain>/.well-known/openid-configuration.

In 1Password: open de discovery-URL in je browser. Issuer is de waarde issuer daarin en User Info Endpoint de waarde userinfo_endpoint. Client Type: Private Client met het client secret van een Web Application. Kies Public Client alleen bij een Native Application of Single-Page Application die clientauthenticatie None gebruikt en PKCE vereist.

Auth0

Gids van 1Password: Configure Unlock 1Password with Auth0.

  1. Voeg in de Auth0-applicatie voor 1Password de XFA redirect URI toe aan Allowed Callback URLs. Scheid hem met een komma van de URL's die er al staan. Klik op Save Changes.
  2. Kopieer de Client ID, en het Client Secret als de applicatie er een heeft.

De discovery-URL is https://<your-domain>.auth0.com/.well-known/openid-configuration.

In 1Password: open de discovery-URL in je browser. Issuer is de waarde issuer daarin en User Info Endpoint de waarde userinfo_endpoint. Client Type: Private Client als de applicatie een client secret heeft, anders Public Client.

JumpCloud

Gids van 1Password: Configure Unlock 1Password with JumpCloud.

  1. Voeg in de JumpCloud OIDC-app voor 1Password, op het tabblad SSO, de XFA redirect URI toe aan Redirect URIs en sla op.
  2. Kopieer de Client ID, en het client secret als de app er een heeft.

De discovery-URL is https://oauth.id.jumpcloud.com/.well-known/openid-configuration, of https://oauth.id.eu.jumpcloud.com/.well-known/openid-configuration voor een EU-account.

In 1Password: open de discovery-URL in je browser. Issuer is de waarde issuer daarin en User Info Endpoint de waarde userinfo_endpoint. Client Type: Private Client als de app een client secret heeft, anders Public Client.

Andere OpenID Connect-providers

Gids van 1Password: Configure Unlock 1Password with other identity providers. Gebruik dit onderdeel voor Duo, OneLogin, Ping Identity en elke andere OpenID Connect-provider.

  1. Voeg in de OpenID Connect-applicatie voor 1Password bij je provider de XFA redirect URI toe aan de toegestane redirect URI's.
  2. Controleer of de provider het e-mailadres in het ID-token zet. Sommige providers hebben daar een instelling of een claim mapping voor nodig.
  3. Kopieer de Client ID, en het client secret als de applicatie er een heeft.

De discovery-URL staat in de documentatie van je provider.

In 1Password: open de discovery-URL in je browser. Issuer is de waarde issuer daarin en User Info Endpoint de waarde userinfo_endpoint. Client Type: Private Client als de applicatie een client secret heeft, anders Public Client.

Unlock with SSO instellen in 1Password

  1. Meld je aan bij je 1Password-account op 1Password.com en selecteer Policies in de zijbalk.
  2. Selecteer onder Single sign-on de optie Manage policies.
  3. Kies Other, ook als je Google gebruikt, en daarna Manual, zodat je elke waarde zelf kunt invullen. 1Password moet eerst met XFA praten. De Google-optie van 1Password zou XFA overslaan.
  4. Vul de velden in:
    • Client ID: van je identity provider
    • Issuer: die van je identity provider
    • Token Endpoint: dat van XFA
    • Authorization Endpoint: dat van XFA
    • User Info Endpoint: dat van je identity provider
    • Client Type: zoals het onderdeel over je provider zegt. 1Password markeert Public Client als aanbevolen; negeer dat label. Kies Private Client als je provider je een client secret gaf (Google doet dat altijd), en plak het in Client secret (value). Kies Public Client alleen als er geen secret is.
  5. Selecteer Next. 1Password toont zijn redirect URI's. Die hoef je niet te kopiëren. XFA heeft ze al ingevuld op basis van je aanmeldadres.
  6. Ga terug naar XFA en klik bij stap 3 in XFA op Markeren als klaar.
  7. Selecteer in 1Password Next en daarna Test Connection. 1Password opent XFA, dat het toestel controleert waarop je werkt en je naar je identity provider stuurt om je aan te melden. Faalt een controle op je toestel, dan toont XFA wat je moet oplossen. Los het op en voer Test Connection opnieuw uit. Test Connection slaat niets op, dus voor anderen verandert er nog niets.
  8. Selecteer Save wanneer de test slaagt. Opslaan vervangt je huidige SSO-instelling: vanaf dan gaat iedereen die 1Password met SSO ontgrendelt door de toestelcontrole van XFA.
  9. Kies onder People unlocking 1Password with an identity provider wie met SSO ontgrendelt. Begin met Only groups you select en een kleine testgroep, en breid dat uit zodra ontgrendelen voor hen werkt. Wanneer mensen overstappen op SSO, vraagt 1Password hen één keer om hun accountwachtwoord en Secret Key.
  10. Ga terug naar XFA en klik bij stap 4 in XFA, Test de verbinding, op Markeren als klaar. Klik daarna op Instellen afronden.

Wat mensen zien

XFA controleert het toestel telkens wanneer 1Password de persoon vraagt zich aan te melden met SSO, in de browser en in de 1Password-apps:

  • In de browser stuurt 1Password de persoon naar XFA, daarna naar de identity provider, en weer terug naar 1Password.
  • In de desktopapp van 1Password opent de browser voor de toestelcontrole en het aanmelden. Is dat klaar, dan vraagt de browser om 1Password te openen en wordt de app ontgrendeld.

Voldoet het toestel niet aan het beleid, dan toont XFA welke controle faalt en hoe je het oplost. Blokkeert je beleid wanneer een controle faalt, dan stopt het ontgrendelen. Waarschuwt het alleen, dan kan de persoon verdergaan. Of een controle blokkeert of waarschuwt, zie je in het beleid, onder Policies in XFA.

XFA controleert het toestel niet wanneer:

  • de persoon ontgrendelt met biometrie (Touch ID, Windows Hello, gezichtsherkenning), omdat dat niet via SSO loopt;
  • de persoon in de groep Owners van 1Password zit;
  • de persoon niet in een groep zit die met SSO ontgrendelt.

De verbinding testen

Elke beheerder kan Test Connection uitvoeren, eigenaars ook: het test de koppeling, niet hun eigen ontgrendeling. Om het ontgrendelen zelf te testen, gebruik je een lid dat geen eigenaar is: eigenaars gebruiken nooit SSO, dus hun ontgrendeling gaat niet via XFA. Voeg dat lid toe aan de testgroep. Vergrendel 1Password en ontgrendel het met SSO in de browser en in de desktopapp. Het lid hoort eerst door de toestelcontrole van XFA en je identity provider te gaan, daarna ontgrendelt 1Password.

Problemen oplossen

De identity provider weigert de redirect URI

Google toont redirect_uri_mismatch wanneer de XFA redirect URI niet in de Authorized redirect URIs van de client staat; andere providers tonen een vergelijkbare fout. Kopieer hem opnieuw uit XFA met de knop Kopiëren, zodat hij precies overeenkomt. Hij ziet eruit als https://device-api.xfa.tech/<application-id>/oauth2/redirect.

Weigert XFA de redirect, dan komt het 1Password-aanmeldadres in XFA niet overeen met je 1Password-account. Corrigeer het in stap 1 in XFA. Gebruik het adres in de adresbalk van je browser wanneer je 1Password gebruikt.

Test Connection mislukt

  • Authorization Endpoint en Token Endpoint in 1Password zijn die van XFA. Issuer en User Info Endpoint zijn die van je identity provider.
  • Client ID, Client Type en het client secret in 1Password komen overeen met de client in je identity provider. Is dat niet zo, dan toont je provider invalid_client.
  • Het toestel waarmee je test, voldoet aan het XFA-beleid dat je hebt gekozen.
  • Je e-mailadres bij de identity provider is hetzelfde als je e-mailadres in 1Password.

Test Connection mislukt met invalid_scope

XFA stopt het aanmelden met invalid_scope wanneer het ID-token van je identity provider geen e-mailadres bevat. Stel je provider zo in dat die het e-mailadres in het ID-token zet: voeg voor Microsoft Entra ID de optionele claim email toe (zie Microsoft Entra ID).

Het toestel voldoet niet aan het beleid

XFA toont de persoon welke controle faalt en hoe de persoon het oplost. Na het oplossen ontgrendelt de persoon 1Password opnieuw. Wil je wijzigen welke controles gelden, bewerk dan het beleid dat aan de 1Password-applicatie in XFA gekoppeld is.