@tomato414941/foundation 0.5.1 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/guide.mjs +11 -2
- package/package.json +1 -1
package/guide.mjs
CHANGED
|
@@ -99,8 +99,17 @@ export function guide(connectors) {
|
|
|
99
99
|
'3. CONNECTING A SERVICE, so that Foundation may obtain credentials there itself. What renews them stays with the',
|
|
100
100
|
' grant, never in a value you can read. Connecting creates one grant, listed with the others.',
|
|
101
101
|
...connectorLines(connectors),
|
|
102
|
-
' POST /v1/requests {"kind":"connect", "input":{"connector":"<id>"
|
|
103
|
-
'
|
|
102
|
+
' POST /v1/requests {"kind":"connect", "input":{"connector":"<id>", "scopes":["<the service\'s scope>", ...]}, "purpose":"...",',
|
|
103
|
+
' "valid_minutes":30} Give the owner the verification_uri.',
|
|
104
|
+
' scopes are the service\'s own names for what the connection may do (see each connector\'s scopes.documentation_url).',
|
|
105
|
+
' Ask for what the work needs; the owner sees each one before agreeing, and decides. Foundation adds only the few',
|
|
106
|
+
' it needs to know who authorized (scopes.base). facts.missing_scopes lists any the service did not grant.',
|
|
107
|
+
' The owner may connect with an OAuth app of their own instead of Foundation\'s (own_client in GET /v1/connectors):',
|
|
108
|
+
' add "client":{"client_id":"<name>","client_secret":"<name>"} naming the given grants that hold its ID and',
|
|
109
|
+
' secret (eBay also "ru_name"). Ask for those with a store request first. The app\'s redirect URL is',
|
|
110
|
+
' <this server>/oauth/<connector id>/callback. With their own app, the owner also decides which scopes can exist.',
|
|
111
|
+
' To reconnect, add "connection_id":"<existing id>" inside input. This updates that connection and keeps its id,',
|
|
112
|
+
' its scopes (add more with scopes) and the app it was made with.',
|
|
104
113
|
' Without connection_id, authorization creates a separate connection, even for the same service user. List and use',
|
|
105
114
|
' an existing connection when no new authorization is needed. Provider consent and revocation may affect several connections.',
|
|
106
115
|
' A connector whose flow is "role" (aws.role) has the owner make a role for Foundation in their own console and',
|
package/package.json
CHANGED