Skip to content

Commit 2740b0b

Browse files
kenchriszolkis
authored andcommitted
Improve explainer with info about ndef and security (#519)
* Improve explainer with info about ndef and security * Further fixes * Spelling nit
1 parent 5ae742d commit 2740b0b

File tree

1 file changed

+23
-6
lines changed

1 file changed

+23
-6
lines changed

EXPLAINER.md

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Field Communication) devices (e.g., tags and phones) in a secure and privacy
1515
preserving manner.
1616

1717
NFC consists of a rather large set of technologies, so for this first iteration
18-
of the API the focus has been on supporting
18+
of the API the focus has been on supporting the NFC Data Exchange Format aka
1919
[NDEF](https://www.oreilly.com/library/view/beginning-nfc/9781449324094/ch04.html),
2020
a lightweight binary message format, as it works across different tag formats.
2121

@@ -58,7 +58,23 @@ Lots of examples can be found here: https://w3c.github.io/web-nfc/#examples
5858

5959
## Key scenarios
6060

61-
Web NFC works well with other existing APIs
61+
Among different use-cases, NFC allows users to take their NFC enabled device
62+
such as a phone and touch NFC tags (sticker, card and the like). The platform,
63+
or a certain application can then at this moment read the content and write
64+
new content back.
65+
66+
Web NFC allows to build web experiences that can do the above, thus exchange
67+
data between the web enabled device and NFC tags.
68+
69+
Data read from NFC tags can come from unknown sources and thus should be
70+
treated like that by web developers. This is no different than treating
71+
user input and data such as JSON, fetched from a remote server.
72+
73+
The NDEF signature records, gives the web site the possibility of verifying
74+
the authenticity and integrity of data within the NDEF message and only deal
75+
with data it trusts.
76+
77+
Additionally, Web NFC integrates well with other existing APIs:
6278

6379
### Integration with Permissions API
6480
The close integration with the [Permissions
@@ -169,9 +185,10 @@ document.onvisibilitychange = event => {
169185
## Detailed design discussion
170186

171187
### Low level API vs standardized NDEF records only
172-
NDEF comes with a set of standard records with data encoded in particular ways,
173-
like text which also encode the encoding and language name, and even
174-
smart-poster, which can contain icons and descriptions in multiple languages.
188+
NDEF (NFC Data Exchange Format) comes with a set of standard records with
189+
data encoded in particular ways, like text which also encode the encoding
190+
and language name, and even smart-poster, which can contain icons and
191+
descriptions in multiple languages.
175192

176193
It would have been possible to just expose these as separate objects, each with
177194
a set of properties. That would solve the common go-to examples for NFC, but it
@@ -228,7 +245,7 @@ running into API issues when extending the API in the future.
228245

229246
- Chrome: Positive (part of Project Fugu)
230247
- Firefox: Positive in the FirefoxOS days, since then, no signals
231-
- Safari: No signals
248+
- Safari: Negative
232249
- Edge: No signals
233250

234251
From speaking about the feature at multiple events over the years, it is clear

0 commit comments

Comments
 (0)