Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add StorageAccessHandle #33391

Merged
merged 29 commits into from
May 22, 2024
Merged
Changes from 1 commit
Commits
Show all changes
29 commits
Select commit Hold shift + click to select a range
56ab95e
Add StorageAccessHandle
arichiv May 3, 2024
f05dabc
fix
arichiv May 3, 2024
34a2b75
fix
arichiv May 3, 2024
3dae799
fix
arichiv May 3, 2024
dfdcfa0
Update files/en-us/web/api/document/requeststorageaccess/index.md
arichiv May 3, 2024
47a01a7
Update files/en-us/web/api/storage_access_api/using/index.md
arichiv May 3, 2024
5e3fa9b
Update files/en-us/web/api/storage_access_api/using/index.md
arichiv May 3, 2024
cd7cad4
Update files/en-us/web/api/storage_access_api/using/index.md
arichiv May 3, 2024
ca39133
Update files/en-us/web/api/storageaccesshandle/index.md
arichiv May 3, 2024
bf60b5d
fix
arichiv May 3, 2024
f6e4023
fix
arichiv May 3, 2024
70603c5
fix
arichiv May 3, 2024
cb6d39c
fix
arichiv May 3, 2024
6d374cf
fix
arichiv May 5, 2024
c4f3492
Merge branch 'main' into patch-3
arichiv May 5, 2024
641eacc
fix
arichiv May 5, 2024
3a9456f
Merge branch 'main' into patch-3
arichiv May 6, 2024
2d43dc9
Merge branch 'main' into patch-3
arichiv May 7, 2024
275de8c
Merge branch 'main' into patch-3
arichiv May 13, 2024
05d72c4
Merge branch 'main' into patch-3
arichiv May 14, 2024
3bfe6b4
Merge branch 'main' into patch-3
arichiv May 15, 2024
5c3ef39
Merge branch 'main' into patch-3
arichiv May 16, 2024
359d1eb
Merge branch 'main' into patch-3
arichiv May 17, 2024
19c8cf6
Merge branch 'main' into patch-3
arichiv May 20, 2024
5cb0515
Merge branch 'main' into patch-3
arichiv May 21, 2024
c08b7ab
Update index.md
arichiv May 21, 2024
fc27bed
Merge branch 'main' into patch-3
arichiv May 21, 2024
d302bed
Merge branch 'main' into patch-3
arichiv May 21, 2024
934cb4a
Merge branch 'main' into patch-3
arichiv May 22, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
Add StorageAccessHandle
  • Loading branch information
arichiv committed May 3, 2024
commit 56ab95e59952ec7fb5cd46f5e5299518d39a9a7d
10 changes: 5 additions & 5 deletions files/en-us/web/api/storage_access_api/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,19 @@ browser-compat:
- api.Document.requestStorageAccess
- api.Document.requestStorageAccessFor
- api.Permissions.permission_storage-access
spec-urls: https://privacycg.github.io/storage-access/
spec-urls:
- https://privacycg.github.io/storage-access/
- https://privacycg.github.io/saa-non-cookie-storage/
---

{{DefaultAPISidebar("Storage Access API")}}

The Storage Access API provides a way for cross-site content loaded in a third-party context (i.e., embedded in an {{htmlelement("iframe")}}) to gain access to [third-party cookies](/en-US/docs/Web/Privacy/Third-party_cookies) that it would typically only have access to in a first-party context (i.e., when loaded directly in a browser tab).
The Storage Access API provides a way for cross-site content loaded in a third-party context (i.e., embedded in an {{htmlelement("iframe")}}) to gain access to [third-party cookies](/en-US/docs/Web/Privacy/Third-party_cookies) and [unpartitioned state](/en-US/docs/Web/Privacy/State_Partitioning#state_partitioning) that it would typically only have access to in a first-party context (i.e., when loaded directly in a browser tab).

The Storage Access API is relevant to user agents that, by default, block access to third-party cookies to improve privacy (for example, to prevent tracking). There are legitimate uses for third-party cookies that we still want to enable, even with these default restrictions in place. Examples include single sign-on (SSO) with federated identity providers (IdPs), or persisting user details such as location data or viewing preferences across different sites.
The Storage Access API is relevant to user agents that, by default, block access to third-party cookies and unpartitioned state to improve privacy (for example, to prevent tracking). There are legitimate uses for third-party cookies and unpartitioned state that we still want to enable, even with these default restrictions in place. Examples include single sign-on (SSO) with federated identity providers (IdPs), or persisting user details such as location data or viewing preferences across different sites.

The API provides methods that allow embedded resources to check whether they currently have access to third-party cookies and, if not, to request access from the user agent.

> **Note:** The _Storage Access API_ name may seem like somewhat of a misnomer, given that it only provides access to cookies, and not other client-side storage mechanisms such as {{domxref("Web_Storage_API", "Web Storage", "", "nocode")}} or {{domxref("IndexedDB_API", "IndexedDB", "", "nocode")}}. The name has been kept generic because it may provide access to other forms of client-side storage in the future.

## Concepts and usage

Browsers implement several storage access features and policies restricting access to third-party cookies. These range from giving embedded resources under each top-level origin a unique cookie storage space ([partitioned cookies](#unpartitioned_versus_partitioned_cookies)) to outright blocking of cookie access when resources are loaded in a third-party context.
Expand Down