fyi.opensocial.provisionGroup

Host-level: an app creates a group for a person and gets its own OAuth session on it. Authenticated twice: the person asking, by service auth from their PDS (they become the founder), and the app, by OAuth client authentication in the body (a client assertion for a confidential client) with a DPoP proof in the `DPoP` header, exactly as at the token endpoint. The app must be one this host provisions for. Returns the group and a token response bound to the proof's key, issued to the app's client id: refreshed, listed and revoked like any other session on the group.

Details · procedure
Kindprocedure
Authorityopensocial.fyi
Indexed

What's different

same NSID · two revisions from the same publisher
opensocial.fyi · namespace authority
opensocial.fyi · namespace authority
12 changes, 6 breaking

Some records or requests that were valid against the base schema aren't valid against this one, so update the code that writes and reads them before relying on it.

Procedure · input

#main
Added

clientAssertion

compatible

New optional property.

string · maxLength: 8192
Added

clientAssertionType

compatible

New optional property.

string · maxLength: 256
Added

clientId

compatible

New required property.

string · maxLength: 2048
Changed

joinPolicy.knownValues

compatible

Added the known value fyi.opensocial.profile#open.

fyi.opensocial.profile#open
Changed

joinPolicy.knownValues

compatible

Added the known value fyi.opensocial.profile#request.

fyi.opensocial.profile#request
Changed

joinPolicy.knownValues

compatible

Added the known value fyi.opensocial.profile#invite.

fyi.opensocial.profile#invite
Changed

metaReadableBy.items

breaking

Type changed.

string→ref fyi.opensocial.defs#audience
Changed

scope

breaking

Gained a maximum length limit.

maxLength: 2048
Changed

stewards.items

breaking

Type changed.

string · did→ref fyi.opensocial.defs#accountRef
Removed

client_assertion

breaking

Property removed.

string
Removed

client_assertion_type

breaking

Property removed.

string
Removed

client_id

breaking

Property removed.

string
7 properties and 4 errors unchanged Open the full schema diff →