Skip to content

Commit 461298b

Browse files
docs: use id.ai as the canonical Internet Identity URL (dfinity#3802)
## Summary Internet Identity's canonical user-facing URL is now `https://id.ai`. This PR updates the documentation (`README.md` and `docs/ii-spec.mdx`) to point readers to `id.ai` instead of the legacy `identity.internetcomputer.org` and `identity.ic0.app` URLs. ## Changes - **README.md**: Update the header link, the prominent URL in the links bar, and the "many more" link to point to `https://id.ai`. - **docs/ii-spec.mdx**: Update the canonical hostname description, the client authentication protocol URLs (`#authorize` endpoint, `postMessage` target origin), the CORS `Access-Control-Allow-Origin` guidance, and the HTTP gateway protocol reference to use `https://id.ai`. Legacy URLs are preserved only where needed for backward-compatibility context (origin validation lists, alias descriptions). ## What is NOT changed - Code files (`.ts`, `.rs`, config, CI) — docs-only. - Historical references (changelogs, security advisories). - Canister-as-a-service URLs (e.g., canister ID on `ic0.app`). - The `HACKING.md` `dfx canister install` command, which references `identity.ic0.app` in a `related_origins` config value. Consistent with the framing already used in `HACKING.md` and `frontend_proposal.md`, which reference `id.ai`. --------- Co-authored-by: Tim Aterton <timothyaterton@users.noreply.github.com>
1 parent cae018a commit 461298b

2 files changed

Lines changed: 9 additions & 9 deletions

File tree

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
<p align="center"><a href="https://identity.internetcomputer.org" target="_blank" rel="noopener noreferrer"><img width="600" src="./ii-logo.png" alt="Internet Identity"/></a></p>
1+
<p align="center"><a href="https://id.ai" target="_blank" rel="noopener noreferrer"><img width="600" src="./ii-logo.png" alt="Internet Identity"/></a></p>
22

33
<p align="center">
44
<a href="https://github.com/dfinity/internet-identity/actions/workflows/canister-tests.yml"><img src="https://github.com/dfinity/internet-identity/actions/workflows/canister-tests.yml/badge.svg" alt="Canister Tests" /></a>
@@ -8,12 +8,12 @@
88
</p>
99

1010
<p align="center">
11-
🔗 <a href="https://identity.internetcomputer.org">https://identity.internetcomputer.org</a> • 📜 <a href="https://internetcomputer.org/docs/current/references/ii-spec">Specification</a> <br/> ― <br/>📚 <a href="https://forum.dfinity.org/c/internet-identity/32">Forum</a> • 🚑 <a href="https://github.com/dfinity/internet-identity/issues/new">Report an Issue</a> • 📞 <a href="https://discord.internetcomputer.org">Discord</a>
11+
🔗 <a href="https://id.ai">https://id.ai</a> • 📜 <a href="https://internetcomputer.org/docs/current/references/ii-spec">Specification</a> <br/> ― <br/>📚 <a href="https://forum.dfinity.org/c/internet-identity/32">Forum</a> • 🚑 <a href="https://github.com/dfinity/internet-identity/issues/new">Report an Issue</a> • 📞 <a href="https://discord.internetcomputer.org">Discord</a>
1212
</p>
1313

1414
---
1515

16-
Internet Identity is an authentication and identity service for the [Internet Computer][ic]. It enables hundreds of thousands of users to securely log in to dapps such as [OISY](https://oisy.com), [Caffeine](https://caffeine.ai), [NNS Dapp](https://nns.internetcomputer.org), [OpenChat](https://oc.app), and [many more](https://identity.internetcomputer.org).
16+
Internet Identity is an authentication and identity service for the [Internet Computer][ic]. It enables hundreds of thousands of users to securely log in to dapps such as [OISY](https://oisy.com), [Caffeine](https://caffeine.ai), [NNS Dapp](https://nns.internetcomputer.org), [OpenChat](https://oc.app), and [many more](https://id.ai).
1717

1818
Internet Identity is:
1919

docs/ii-spec.mdx

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -71,7 +71,7 @@ Just for background: At launch this meant we relied on the trustworthiness of th
7171

7272
## Identity design and data model
7373

74-
The Internet Computer serves this frontend under hostnames `https://identity.internetcomputer.org` (official) and `https://identity.ic0.app` (legacy).
74+
The Internet Computer serves this frontend under the hostname `https://id.ai` (official), with `https://identity.internetcomputer.org` and `https://identity.ic0.app` as legacy aliases.
7575

7676
The canister maintains a salt (in the following the `salt`), a 32 byte long blob that is obtained via the Internet Computer's source of secure randomness.
7777

@@ -137,7 +137,7 @@ sequenceDiagram
137137

138138
2. It installs a `message` event handler on its own `window`.
139139

140-
3. It loads the url `https://identity.internetcomputer.org/#authorize` in a separate tab. Let `identityWindow` be the `Window` object returned from this.
140+
3. It loads the url `https://id.ai/#authorize` in a separate tab. Let `identityWindow` be the `Window` object returned from this.
141141

142142
4. In the `identityWindow`, the user logs in, and the `identityWindow` invokes
143143

@@ -156,7 +156,7 @@ sequenceDiagram
156156
5. The client application, after receiving the `InternetIdentityReady`, invokes
157157

158158
```ts
159-
identityWindow.postMessage(msg, "https://identity.internetcomputer.org");
159+
identityWindow.postMessage(msg, "https://id.ai");
160160
```
161161

162162
where `msg` is a value of type
@@ -186,7 +186,7 @@ sequenceDiagram
186186

187187
6. Now the client application window expects a message back, with data `event`.
188188

189-
7. If `event.origin` is not either `"https://identity.ic0.app"` or `"https://identity.internetcomputer.org"` (depending on which endpoint you are using), ignore this message.
189+
7. If `event.origin` is not one of `"https://id.ai"`, `"https://identity.internetcomputer.org"`, or `"https://identity.ic0.app"`, ignore this message.
190190

191191
8. The `event.data` value is a JS object with the following type:
192192

@@ -332,7 +332,7 @@ To prevent misuse of this feature, the number of alternative origins _must not_
332332
:::
333333

334334
:::note
335-
In order to allow Internet Identity to read the path `/.well-known/ii-alternative-origins`, the CORS response header [`Access-Control-Allow-Origin`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin) must be set and allow the Internet Identity origin `https://identity.internetcomputer.org`.
335+
In order to allow Internet Identity to read the path `/.well-known/ii-alternative-origins`, the CORS response header [`Access-Control-Allow-Origin`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin) must be set and allow the Internet Identity origin being used, for example `https://id.ai`, `https://identity.internetcomputer.org`, or `https://identity.ic0.app`.
336336
:::
337337

338338
## The Internet Identity Service Backend interface
@@ -347,7 +347,7 @@ Note that the interface is split into 4 categories:
347347
- The aim of the API v2 is to introduce changes that cannot be made without breaking existing clients of the legacy API. While the API v2 has feature parity with the legacy API, the desired changes are not fully implemented yet:
348348
- Methods should return proper results with meaningful errors.
349349
- Adding explicit WebAuthn signatures to security critical operations.
350-
- HTTP gateway protocol, required to serve `https://identity.internetcomputer.org`.
350+
- HTTP gateway protocol, required to serve `https://id.ai`.
351351
- Auth protocol, for creating signed delegations.
352352
- Verifiable credentials protocol, for creating id alias credentials.
353353
- Internal methods, not intended to be called by external clients.

0 commit comments

Comments
 (0)