Samprix

Passkey Readiness Checker

See whether password managers, browsers and your apps can find and share a domain’s passkeys, and what to fix in each file they read.

  • Public data only
  • Results in seconds
  • No sign-up
  • Free
Readiness Partly set up
Passkey endpoints Not published
Related origins None
Apps sharing passkeys None

Results for github.com

Passkey endpoints

/.well-known/passkey-endpoints

Lets password managers offer to create a passkey for your site and link to your passkey pages.

  • Warning:No passkey-endpoints file

    Password managers (1Password, Bitwarden, Google and Apple) use /.well-known/passkey-endpoints to offer “Create a passkey for this site” and link straight to your page. Without it they can’t tell people your site supports passkeys.

Related origins

/.well-known/webauthn

Lets one passkey work across your other domains (up to 5 distinct names).

  • Note:No related origins file

    Passkeys made on this domain only work on it and its subdomains. That’s fine unless you run the same sign-in on other domains (example.co.uk, example-app.com): list those in /.well-known/webauthn so one passkey works on all of them.

iPhone, iPad and Mac apps

/.well-known/apple-app-site-association

Lets your Apple apps use the same passkeys as the website.

  • Note:No "webcredentials" section

    The file sets up universal links, but no app is allowed to use this domain’s passkeys. If your iOS app signs in, add {"webcredentials": {"apps": ["TEAMID.com.example.app"]}}.

File as served
{
  "applinks": {
    "defaults": {
      "caseSensitive": false
    },
    "substitutionVariables": {
      "excludedProducts": [
        "_graphql",
        "about",
        "accelerator",
        "account",
        "actions-beta",
        "addons",
        "admin",
        "advisories",
        "advisory-database",
        "advisory-db",
        "advisorydatabase",
        "advisorydb",
        "all-in-open-source",
        "anonymous",
        "any",
        "api",
        "apple-app-site-association",
        "apps",
        "assets-cdn",
        "assets",
        "attributes",
        "auth",
        "avatars",
        "baitshop",
        "billing",
        "blob",
        "blog",
        "bounty",
        "branches",
        "brand",
        "buildingthefuture",
        "business",
        "businesses",
        "c",
        "cache",
        "callbacks",
        "camo",
        "careers",
        "categories",
        "central",
        "certification",
        "certifications",
        "changelog",
        "chat",
        "cla",
        "cloud",
        "codeload",
        "codeql",
        "codereview",
        "codesearch",
        "codespaces",
        "collection",
        "collections",
        "collector-cdn",
        "comments",
        "commit",
        "commits",
        "companies",
        "compare",
        "contact-sales",
        "contact",
        "contributing",
        "cookbook",
        "copilot",
        "coupons",
        "ctags",
        "customer-stories",
        "customer",
        "customers",
        "dashboard",
        "dashboards",
        "de",
        "dependency-insights",
        "design-blog",
        "design-system",
        "design-team",
        "design",
        "designs-system",
        "designs-systems",
        "develop",
        "developer-stories",
        "developer",
        "devtools",
        "diff",
        "difftool",
        "discover",
        "discussion_messages",
        "discussions",
        "downloads",
        "downtime",
        "earlyaccess",
        "edit_repositories",
        "editor",
        "editors",
        "edu",
        "education",
        "email",
        "enterprise-cloud",
        "enterprise-docs",
        "enterprise-legal",
        "enterprise-server",
        "enterprise",
        "enterprises",
        "error_pages",
        "events",
        "experience",
        "explore",
        "featured",
        "features",
        "file-servers",
        "files",
        "fixtures",
        "forked",
        "fr",
        "frequently-asked-questions",
        "g1thub",
        "game-off",
        "gameoff",
        "garage",
        "generated_pages",
        "geocities",
        "getting-started",
        "gist-assets",
        "gist-raw",
        "gist",
        "gists",
        "github_spark_waitlist_signup",
        "github-and-vscode",
        "github-apps",
        "github-copilot",
        "github-design-systems",
        "github-outreach",
        "gitlfs",
        "glthub",
        "graphs",
        "guide",
        "guides",
        "halp",
        "help-wanted",
        "help",
        "home",
        "hooks",
        "hosting",
        "identicons",
        "identity",
        "images",
        "inbox",
        "individual",
        "info",
        "integration",
        "interfaces",
        "introduction",
        "investors",
        "javascripts",
        "jobs",
        "join",
        "journal",
        "journals",
        "jump-to",
        "lab",
        "labs",
        "languages",
        "launch",
        "layouts",
        "learn",
        "legal",
        "libgit2-ci",
        "library",
        "linux",
        "listings",
        "lists",
        "login",
        "logos",
        "logout",
        "mac",
        "machine-room",
        "mailers",
        "maintenance",
        "malware",
        "man",
        "marketplace",
        "mcp",
        "media",
        "mention",
        "mentioned",
        "mentioning",
      
…

Android apps

/.well-known/assetlinks.json

Lets your Android apps use the same passkeys as the website.

  • Note:com.github.android.dev, com.github.android.staff, com.github.android can’t use this domain’s passkeys

    The statement doesn’t include "delegate_permission/common.get_login_creds". Add it to the relation list so Credential Manager lets the app use the website’s passkeys.

  • com.github.android.dev app links only · 2 fingerprints
  • com.github.android.staff app links only · 1 fingerprint
  • com.github.android app links only · 1 fingerprint
File as served
[
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.github.android.dev",
      "sha256_cert_fingerprints": [
        "94:53:53:34:54:66:B1:30:4B:3C:67:9D:E7:9C:C2:AA:77:E4:4E:FF:1B:1A:F8:D9:64:C8:79:82:16:CC:88:68",
        "3C:B3:96:8D:FD:F5:17:27:EC:DD:C2:EB:08:D8:27:BF:45:63:43:59:35:1F:FA:DD:6B:FD:2D:8A:E0:D0:68:6B"
      ]
    }
  },
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.github.android.staff",
      "sha256_cert_fingerprints": [
        "F6:50:1D:96:30:92:5A:AF:2E:AF:B0:CE:51:F5:43:C6:BE:89:D8:68:C8:3F:92:05:06:A4:6F:E5:DA:49:AA:2E"
      ]
    }
  },
  {
    "relation": [
      "delegate_permission/common.handle_all_urls"
    ],
    "target": {
      "namespace": "android_app",
      "package_name": "com.github.android",
      "sha256_cert_fingerprints": [
        "DF:08:C9:F2:D8:09:18:9D:9D:50:64:97:C1:57:45:A7:39:5A:41:53:6E:FB:43:3E:3A:EE:1A:ED:BE:11:B2:61"
      ]
    }
  }
]

Change-password link

/.well-known/change-password

Where password managers send people to replace a weak password, or switch to a passkey.

  • OK:Change-password link works

    It redirects to https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fsettings%2Fsecurity.

Advertisement

Publishing the passkey files

All of these live under /.well-known/ on the domain you use as the relying party ID (usually your main domain). Serve each one directly, with no redirect, over HTTPS, and the JSON files with Content-Type: application/json.

  1. passkey-endpoints: {"enroll": "https://example.com/account/passkeys/new", "manage": "https://example.com/account/passkeys"}
  2. webauthn, only if other domains share your sign-in: {"origins": ["https://example.co.uk", "https://example-app.com"]}
  3. apple-app-site-association, for Apple apps: {"webcredentials": {"apps": ["ABCDE12345.com.example.app"]}}, plus the webcredentials:example.com entitlement in the app.
  4. assetlinks.json, for Android apps: a statement with the relations delegate_permission/common.handle_all_urls and delegate_permission/common.get_login_creds, the package name and the SHA-256 fingerprint of the signing certificate.
  5. change-password: a redirect (302 or 303) from /.well-known/change-password to your change-password page.

Common problems

  • A redirect to www: the bare domain redirects every path to www, so the files never load from the relying party ID. Exempt /.well-known/ from the redirect.
  • Served as text/plain or octet-stream: files without an extension get the wrong type. Set it for each path in nginx, Apache or your CDN.
  • Blocked by a firewall or bot protection: browsers and Apple’s CDN fetch these files without cookies. A challenge page or a login wall in front of /.well-known/ breaks them.
  • More than five names in related origins: browsers ignore the rest. Country domains of the same name (example.com, example.de) count as one.

Did this tool do what you needed?

All tools