wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Move brand registry out of structured data directory

Browse source 
Markdown is not structured data.
This commit is contained in:
Travis Ralston 2021-05-01 00:54:14 -06:00 • committed by Richard van der Hoff
parent d9bb8f46d1
commit c124462747
2 changed files with 1 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

67
informal/idp-brands.md Normal file
View file

@ -0,0 +1,67 @@
# SSO IdP brand registry
This informal document contains specification for common brands that clients might experience
in the wild as part of `m.login.sso` flows. To add your brand, open a PR against this document
with the relevant additions (using the existing specification as reference) - an MSC is not
required. Once opened, mention your PR in [#sct-office:matrix.org](https://matrix.to/#/#sct-office:matrix.org)
on Matrix so it doesn't end up lost.
Please also take some time to read the [contributing guidelines](https://github.com/matrix-org/matrix-doc/blob/master/CONTRIBUTING.rst)
for an overview of PR requirements.
<!--
Author's note: This document intentionally has 2 blank lines between brands for easier distinction
in the plaintext version. Please maintain them for new & existing brands.
-->
## Brands
For the brands listed here, the `identifier` would be used as the `brand` value in an IdP definition
under `m.login.sso`'s flow.
Note that each brand may have their own requirements for how they are represented by clients, such as
Facebook/Twitter wanting their signature blues for button backgrounds whereas Github is not as particular
about the press requirements. Clients should not rely on this document for guidance on press requirements
and instead refer to the brands individually.
### Apple
**Identifier**: `apple`
Suitable for "Sign in with Apple": see https://developer.apple.com/design/human-interface-guidelines/sign-in-with-apple/overview/buttons/.
### Facebook
**Identifier**: `facebook`
"Continue with Facebook": see https://developers.facebook.com/docs/facebook-login/web/login-button/.
### GitHub
**Identifier**: `github`
Logos available at https://github.com/logos.
### Gitlab
**Identifier**: `gitlab`
Logos available at https://about.gitlab.com/press/press-kit/.
### Google
**Identifier**: `google`
Suitable for "Google Sign-In": see https://developers.google.com/identity/branding-guidelines.
### Twitter
**Identifier**: `twitter`
Suitable for "Log in with Twitter": see https://developer.twitter.com/en/docs/authentication/guides/log-in-with-twitter#tab1.