pomerium/docs/guides/enroll-device.md
Alex Fornuto 64d50613af
DOCS: keyword tag updates (#2922)
* replace "zero-trust" with "zero trust"

* fix and update all keyword tags
2022-01-11 12:36:47 -06:00

2.3 KiB

title lang meta description
Enroll a Device en-US
name content
keywords pomerium, identity access proxy, webauthn, device id, enroll, enrollment, authentication, authorization
This guide covers how to enroll a trusted execution environment device as a Pomerium end-user.

Enroll a Device

If a Pomerium route is configured to require device authentication, then the user must register a trusted execution environment (TEE) device before accessing the route. Registration is easy, but different depending on the device being used to provide ID.

  1. Users are prompted to register a new device when accessing a route that requires device authentication:

    The WebAuthn Registration page with no devices registered

    Users can also get to the registration page from the special .pomerium endpoint available on any route, at the bottom of the page:

    The Device Credentials section of the .pomerium endpoint with the WebAuthn link highlighted

  2. Click on Register New Device. Your browser will prompt you to provide access to a device. This will look different depending on the browser, operating system, and device type:

    ::::: tabs :::: tab Windows The device authentication prompt on Windows :::: :::: tab Chrome The device authentication prompt in Google Chrome :::: :::: tab Firefox The device authentication prompt in Firefox :::: :::: tab ChromeOS The device authentication prompt on ChromeOS ::::

Find Device ID

If a route's policy is configured to only allow specific device IDs you will see a 450 error even after registering:

450 device not authorized error screen

From the .pomerium endpoint you can copy your device ID to provide to your Pomerium administrator.

Device ID list at /.pomerium

From here you can also delete the ID for devices that should no longer be associated with your account.