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
| Kind | procedure |
|---|---|
| Authority | opensocial.fyi |
| Indexed |
What's different
same NSID · two revisions from the same publisherSome 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
#mainclientAssertion
compatibleNew optional property.
string · maxLength: 8192 clientAssertionType
compatibleNew optional property.
string · maxLength: 256 clientId
compatibleNew required property.
string · maxLength: 2048 joinPolicy.knownValues
compatibleAdded the known value fyi.opensocial.profile#open.
fyi.opensocial.profile#open joinPolicy.knownValues
compatibleAdded the known value fyi.opensocial.profile#request.
fyi.opensocial.profile#request joinPolicy.knownValues
compatibleAdded the known value fyi.opensocial.profile#invite.
fyi.opensocial.profile#invite metaReadableBy.items
breakingType changed.
stringref fyi.opensocial.defs#audience scope
breakingGained a maximum length limit.
maxLength: 2048 stewards.items
breakingType changed.
string · didref fyi.opensocial.defs#accountRef client_assertion
breakingProperty removed.
stringclient_assertion_type
breakingProperty removed.
stringclient_id
breakingProperty removed.
string