You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
matrix-spec/registry/m.login.sso_brand.md

60 lines
2.0 KiB
Markdown

# `m.login.sso` `brand` identifier registry
The following is a list of identifiers for use in the optional `brand` field of the
`identity_providers` property of the response to the [`GET /_matrix/client/r0/login`
endpoint](https://matrix.org/docs/spec/client_server/latest#get-matrix-client-r0-login).
This field was originally proposed in
[MSC2858](https://github.com/matrix-org/matrix-doc/pull/2858).
Links to other organisations' branding guidelines are provided on an
informational basis, to help client developers understand the expected
behaviour. No guarantee is given as to their accuracy, and each client author
remains responsible for maintaining their application according to the latest
best practices.
## Assignments
<!--
Note that the following list is alphabetical by identifier - please keep it
that way!
-->
* Identifier: `com.apple`
Description: "Sign in with Apple". See
https://developer.apple.com/design/human-interface-guidelines/sign-in-with-apple/overview/buttons/.
* Identifier: `com.facebook`
Description: "Continue with Facebook". See
https://developers.facebook.com/docs/facebook-login/web/login-button/.
* Identifier: `com.github`
Description: Logos available at https://github.com/logos.
* Identifier: `com.gitlab`
Description: Login in via the hosted https:/gitlab.com SaaS platform.
* Identifier: `com.google`
Description: "Sign in with Google". See
https://developers.google.com/identity/branding-guidelines.
* Identifier: `com.twitter`
Description: "Log in with Twitter". See
https://developer.twitter.com/en/docs/authentication/guides/log-in-with-twitter#tab1.
## Requesting updates to the list
Members of the community wishing to add new brands to this list are encouraged
to open a pull request to update the list.
Contributors are reminded that identifiers for the `brand` field should follow
the [common textual identifier
grammar](https://github.com/matrix-org/matrix-doc/blob/rav/proposals/textual_identifier_grammar/proposals/2758-textual-id-grammar.md).