Add notes

Author: jason-fox

README.ja.md

@@ -399,7 +399,7 @@ Super-User は、`alice-the-admin@test.com` と `test` の値を持っていま
 
 次の例では、Admin Super-User を使用してログインします :
 
-#### :one: リクエスト:
+#### 1️⃣ リクエスト:
 
 ```console
 curl -iX POST \
@@ -452,7 +452,7 @@ Connection: keep-alive
 ることができます。`{{X-Auth-token}}` と `{{X-Subject-token}}` は、Alice が自分自
 身について問い合わせを行っている場合に同じ値に設定することができます。
 
-#### :two: リクエスト:
+#### 2️⃣ リクエスト:
 
 ```console
 curl -X GET \
@@ -542,7 +542,7 @@ curl -X GET \
 `/v1/applications/{{application-id}}/pep_proxies` エンドポイントに POST リクエス
 トを送信します。
 
-#### :three: リクエスト:
+#### 3️⃣ リクエスト:
 
 ```console
 curl -iX POST \
@@ -574,7 +574,7 @@ curl -iX POST \
 トを行うと、関連する PEP Proxy アカウントの詳細が返されます。`X-Auth-token` をヘ
 ッダに指定してしてください。
 
-#### :four: リクエスト:
+#### 4️⃣ リクエスト:
 
 ```console
 curl -X GET \
@@ -602,7 +602,7 @@ PEP Proxy アカウントのパスワードを更新するには
 クエストを実行し、関連する PEP Proxy アカウントの詳細が返されます
 。`X-Auth-token` をヘッダに指定してしてください。
 
-#### :five: リクエスト:
+#### 5️⃣ リクエスト:
 
 ```console
 curl -X PATCH \
@@ -629,7 +629,7 @@ curl -X PATCH \
 エンドポイントに DELETE リクエストを行うことで削除できます。`X-Auth-token` をヘ
 ッダに指定してしてください。
 
-#### :six: リクエスト:
+#### 6️⃣ リクエスト:
 
 ```console
 curl -X DELETE \
@@ -664,7 +664,7 @@ PEP Proxy 作成と同様に、サイン・インして、ユーザはアプリ
 `/v1/applications/{{application-id}}/iot_agents` エンドポイントに POST リクエス
 トを送信します。
 
-#### :seven: リクエスト:
+#### 7️⃣  リクエスト:
 
 ```console
 curl -X POST \
@@ -696,7 +696,7 @@ GET リクエストを作成すると
 トは関連する IoT Agent アカウントの詳細を返します。`X-Auth-token` をヘッダに指定
 してしてください。
 
-#### :eight: リクエスト:
+#### 8️⃣  リクエスト:
 
 ```console
 curl -X GET \
@@ -723,7 +723,7 @@ curl -X GET \
 を実行することによって、アプリケーションに関連するすべての IoT Agents のリストを
 得ることができる。`X-Auth-token` をヘッダに指定してしてください。
 
-#### :nine: リクエスト:
+#### 9️⃣ リクエスト:
 
 ```console
 curl -X GET \
@@ -750,7 +750,7 @@ curl -X GET \
 
 ### IoT Agent のパスワードをリセット
 
-#### :one::zero: リクエスト:
+#### 1️⃣0️⃣ リクエスト:
 
 個々の IoT Agent アカウントのパスワードを更新するには
 、`/v1/applications/{{application-id}}//iot_agents/{{iot-agent-id}}` エンドポイ
@@ -783,7 +783,7 @@ curl -iX PATCH \
 トに DELETE リクエストを行うことで削除できます。`X-Auth-token` をヘッダに指定し
 てしてください。
 
-#### :one::one: リクエスト:
+#### 1️⃣1️⃣ リクエスト:
 
 ```console
 curl -X DELETE \
@@ -954,7 +954,7 @@ tutorial-app:
 Broker の前にあります。リクエストには、`X-Auth-Token` を含める必要があります。有
 効なトークンを提示できないと、アクセスが拒否されます。
 
-#### :one::two: リクエスト:
+#### 1️⃣2️⃣ リクエスト:
 
 以下のようにアクセス・トークンなしで PEP Proxy へのリクエストが行われた場合は :
 
@@ -975,7 +975,7 @@ Auth-token not found in request header
 
 ### Keyrock - ユーザによるアクセス・トークンの取得
 
-#### :one::three: リクエスト:
+#### 1️⃣3️⃣ リクエスト:
 
 ユーザ・クレデンシャルのフローを使用してアプリケーションにログインするには
 、`oauth2/token` エンドポイントを使用して、`grant_type=password` とともに
@@ -1016,7 +1016,7 @@ curl -iX POST \
 Proxy へのリクエストが行われた場合、そのリクエストは許可され、PEP Proxy の背後に
 あるサービス (この場合は Orion Context Broker) が期待通りにデータを返します。
 
-#### :one::four: リクエスト:
+#### 1️⃣4️⃣ リクエスト:
 
 ```console
 curl -X GET \
@@ -1051,7 +1051,7 @@ curl -X GET \
 標準の `Authorization: Bearer` ヘッダを使用してユーザを識別することもできます。承認されたユーザからのリクエストが許可
 され、PEP Proxy の背後にあるサービス (この場合は Orion Context Broker) が期待どおりにデータを返します。
 
-#### :one::five: リクエスト:
+#### 1️⃣5️⃣ リクエスト:
 
 ```console
 curl -X GET \
@@ -1303,7 +1303,7 @@ IoT センサとしてのログインは、ユーザと同じユーザ・クレ
 POST リクエストを送ります :
 
 
-#### :one::five: リクエスト:
+#### 1️⃣5️⃣ リクエスト:
 
 ```console
 curl -iX POST \
@@ -1339,7 +1339,7 @@ Ultralight IoT Agent の前にある PEP Proxy への POST リクエストは、
 定値を渡します。`X-Auth-Token` ヘッダを追加すると、リクエスト元が Keyrock に登録
 されていると識別され、測定が IoT Agent 自体に正常に渡されます。
 
-#### :one::six: リクエスト:
+#### 1️⃣6️⃣ リクエスト:
 
 ```console
 curl -X POST \
@@ -1483,7 +1483,7 @@ Keyrock アプリケーションは、永久トークンを提供するように
 `scope=permanent` が追加され、利用可能な場合に永続トークンを取得します。レスポンスには、デバイスのプロビジョニングに
 使用できる `access_token` が含まれています。
 
-#### :one::seven: リクエスト:
+#### 1️⃣7️⃣  リクエスト:
 
 ```console
 curl -X POST \
@@ -1520,7 +1520,7 @@ curl -X POST \
 }
 ```
 
-#### :one::eight: リクエスト:
+#### 1️⃣8️⃣  リクエスト:
 
 ```console
 curl -iX PUT \
@@ -1542,7 +1542,7 @@ curl -iX PUT \
 
 信頼できるサービス・グループが作成されると、通常の方法でデバイスをプロビジョニングできます。
 
-#### :one::nine: リクエスト:
+#### 1️⃣9️⃣ リクエスト:
 
 ```console
 curl -iX POST \

README.md

@@ -330,7 +330,7 @@ and `test`. The URL `https://localhost:3443/v1/auth/tokens` should also work in
 
 The following example logs in using the Admin Super-User:
 
-#### :one: Request:
+#### 1️⃣ Request:
 
 ```console
 curl -iX POST \
@@ -379,7 +379,7 @@ You can use the long-lasting `X-Auth-token=aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa`
 tutorial. Both `{{X-Auth-token}}` and `{{X-Subject-token}}` can be set to the same value in the case that Alice is
 making an enquiry about herself.
 
-#### :two: Request:
+#### 2️⃣ Request:
 
 ```console
 curl -X GET \
@@ -452,7 +452,7 @@ To create a new PEP Proxy account within an application, send a POST request to
 `/v1/applications/{{application-id}}/pep_proxies` endpoint along with the `X-Auth-token` header from a previously logged
 in administrative user.
 
-#### :three: Request:
+#### 3️⃣ Request:
 
 ```console
 curl -iX POST \
@@ -480,7 +480,7 @@ created with a unique `id` and `password` and the values will be returned in the
 Making a GET request to the `/v1/applications/{{application-id}}/pep_proxies` endpoint will return the details of the
 associated PEP Proxy Account. The `X-Auth-token` must be supplied in the headers.
 
-#### :four: Request:
+#### 4️⃣ Request:
 
 ```console
 curl -X GET \
@@ -505,7 +505,7 @@ To renew the password of a PEP Proxy Account, make a PATCH request to the
 `/v1/applications/{{application-id}}/pep_proxies` endpoint will return the details of the associated PEP Proxy Account.
 The `X-Auth-token` must be supplied in the headers.
 
-#### :five: Request:
+#### 5️⃣ Request:
 
 ```console
 curl -X PATCH \
@@ -529,7 +529,7 @@ The response returns a new password for the PEP Proxy Account
 An existing PEP Proxy Account can be deleted by making a DELETE request to the
 `/v1/applications/{{application-id}}/pep_proxies` endpoint. The `X-Auth-token` must be supplied in the headers.
 
-#### :six: Request:
+#### 6️⃣ Request:
 
 ```console
 curl -X DELETE \
@@ -558,7 +558,7 @@ To create a new IoT Agent account within an application, send a POST request to
 `/v1/applications/{{application-id}}/iot_agents` endpoint along with the `X-Auth-token` header from a previously logged
 in administrative user.
 
-#### :seven: Request:
+#### 7️⃣  Request:
 
 ```console
 curl -X POST \
@@ -585,7 +585,7 @@ A new account will be created with a unique `id` and `password` and the values w
 Making a GET request the `/v1/applications/{{application-id}}/iot_agents/{{iot-agent-id}}` endpoint will return the
 details of the associated IoT Agent Account. The `X-Auth-token` must be supplied in the headers.
 
-#### :eight: Request:
+#### 8️⃣  Request:
 
 ```console
 curl -X GET \
@@ -609,7 +609,7 @@ curl -X GET \
 A list of all IoT Agents associated with an application can be obtained by making a GET request the
 `/v1/applications/{{application-id}}/iot_agents` endpoint. The `X-Auth-token` must be supplied in the headers.
 
-#### :nine: Request:
+#### 9️⃣ Request:
 
 ```console
 curl -X GET \
@@ -634,7 +634,7 @@ curl -X GET \
 
 ### Reset Password of an IoT Agent
 
-#### :one::zero: Request:
+#### 1️⃣0️⃣ Request:
 
 To renew the password of an individual IoT Agent Account, make a PATCH request to the
 `/v1/applications/{{application-id}}//iot_agents/{{iot-agent-id}}` endpoint. The `X-Auth-token` must be supplied in the
@@ -663,7 +663,7 @@ An existing IoT Agent Account can be deleted by making a DELETE request to the
 `/v1/applications/{{application-id}}/iot_agents/{{iot-agent-id}}` endpoint. The `X-Auth-token` must be supplied in the
 headers.
 
-#### :one::one: Request:
+#### 1️⃣1️⃣ Request:
 
 ```console
 curl -X DELETE \
@@ -814,7 +814,7 @@ Secured Access can be ensured by requiring all requests to the secured service a
 this case the PEP Proxy is found in front of the Context Broker). Requests must include an `X-Auth-Token`, failure to
 present a valid token results in a denial of access.
 
-#### :one::two: Request:
+#### 1️⃣2️⃣ Request:
 
 If a request to the PEP Proxy is made without any access token as shown:
 
@@ -833,7 +833,7 @@ Auth-token not found in request header
 
 ### Keyrock - User Obtains an Access Token
 
-#### :one::three: Request:
+#### 1️⃣3️⃣ Request:
 
 To log in to the application using the user-credentials flow send a POST request to **Keyrock** using the `oauth2/token`
 endpoint with the `grant_type=password`. For example to log-in as Alice the Admin:
@@ -869,7 +869,7 @@ If a request to the PEP Proxy is made including a valid access token in the `X-A
 is permitted and the service behind the PEP Proxy (in this case the Orion Context Broker) will return the data as
 expected.
 
-#### :one::four: Request:
+#### 1️⃣4️⃣ Request:
 
 ```console
 curl -X GET \
@@ -883,7 +883,7 @@ The standard `Authorization: Bearer` header can also be used to identity the use
 is permitted and the service behind the PEP Proxy (in this case the Orion Context Broker) will return the data as
 expected.
 
-#### :one::five: Request:
+#### 1️⃣5️⃣ Request:
 
 ```console
 curl -X GET \
@@ -1066,7 +1066,7 @@ this case Kong is acting as a PEP Proxy is found in front of the Context Broker)
 Successful requests must include an `Authentiction` header, failure to present a valid token results in a denial of
 access.
 
-#### :one::six: Request:
+#### 1️⃣6️⃣ Request:
 
 If a request to the PEP Proxy is made without any access token as shown:
 
@@ -1085,7 +1085,7 @@ Request forbidden by authorization service Keyrock.
 
 ### Keyrock - User Obtains an Access Token
 
-#### :one::seven: Request:
+#### 1️⃣7️⃣  Request:
 
 To log in to the application using the user-credentials flow send a POST request to **Keyrock** using the `oauth2/token`
 endpoint with the `grant_type=password`. For example to log-in as Alice the Admin:
@@ -1121,7 +1121,7 @@ If a request to the PEP Proxy is made including a valid access token in the `X-A
 is permitted and the service behind the PEP Proxy (in this case the Orion Context Broker) will return the data as
 expected.
 
-#### :one::eight: Request:
+#### 1️⃣8️⃣  Request:
 
 ```console
 curl -X GET \
@@ -1290,7 +1290,7 @@ Logging in as an IoT Sensor follows the same user-credentials flow as for a User
 `iot_sensor_00000000-0000-0000-0000-000000000000` with password `test` send a POST request to **Keyrock** using the
 `oauth2/token` endpoint with the `grant_type=password`:
 
-#### :one::five: Request:
+#### 1️⃣5️⃣ Request:
 
 ```console
 curl -iX POST \
@@ -1323,7 +1323,7 @@ The POST request to a PEP Proxy in front to the Ultralight IoT Agent identifies
 the source of the request as being registered in Keyrock, and therefore the measurement will be successfully passed on
 to the IoT Agent itself.
 
-#### :one::nine: Request:
+#### 1️⃣9️⃣ Request:
 
 ```console
 curl -X POST \
@@ -1454,7 +1454,7 @@ The standard `Authorization: Basic` header holds the base 64 concatentation of t
 `scope=permanent` is added to retrieve permanent tokens when available. The response contains an `access_token` which
 can be used for device provisioning.
 
-#### :two::zero: Request:
+#### 2️⃣0️⃣ Request:
 
 ```console
 curl -X POST \
@@ -1489,7 +1489,7 @@ been provisioned as shown:
 }
 ```
 
-#### :two::one: Request:
+#### 2️⃣1️⃣ Request:
 
 > **Note:** use the `access_token` from the previous request.
 
@@ -1511,7 +1511,7 @@ The Motion sensor requests are now sent via the `orion-proxy` and identify thems
 
 Once a trusted service group has been created, a device can be provisioned in the usual manner
 
-#### :two::two: Request:
+#### 2️⃣2️⃣ Request:
 
 ```console
 curl -iX POST \