user docs: Update logging-in.md.

This commit is contained in:
Lyla Fischer 2018-05-14 17:42:37 -04:00 committed by Rishi Gupta
parent 2807189d87
commit 7fba0f1505
7 changed files with 30 additions and 66 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 80 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 40 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 42 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.3 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 3.4 KiB

View File

@ -1,81 +1,45 @@
# Logging in
Zulip offers three ways to log in: e-mail and password, Google
credentials, and GitHub credentials. Your organization's administrator
may choose to enable or disable any of these options. So don't worry
if your login page doesn't have some of the options described here!
By default, Zulip allows you to log with an email/password pair, a Google account, or
a GitHub account.
## Logging in with your email address
Organization administrators can
[add other authentication methods](configure-authentication-methods),
including SSO or LDAP integration, or disable any of the methods above.
You can log into your Zulip organization using your email address by
following a few simple steps.
To log in, go to your organization's Zulip URL and follow the on-screen instructions.
1. In the field labeled **Email**, enter the email address that you
used to sign up for Zulip. Please note that the **Email** field is
case-sensitive.
!!! tip ""
You can log in with any method, regardless of how you signed up. E.g. if
you originally signed up using your Google account, you can later log in
using GitHub, as long as your Google account and GitHub account use the
same email address.
!!! tip ""
If you've forgotten which email you used to sign up for
Zulip, you can try searching your email accounts for the
e-mail you received when you first signed up. The subject line
is "Welcome to Zulip".
## Troubleshooting
2. In the field labeled **Password**, enter your password. Please note
that the **Password** field is case-sensitive.
### I don't know my Zulip URL
!!! tip ""
If you've forgotten your password, see the
[Change your password](/help/change-your-password) page for
instructions on how to reset it.
Some ideas:
## Logging in with your Google account
* If you know your organization is hosted on
[zulipchat.com](https://zulipchat.com), go to
[find my account](https://zulipchat.com/accounts/find/) and enter the email
address that you signed up with.
If your organization has enabled Google authentication, you can log
into Zulip using your Google account by following a few simple steps.
* Try guessing the URL. Zulip URLs often look like `<name>.zulipchat.com`,
`zulip.<name>.com`, or `chat.<name>.com` (replace `<name>` with the name of your
organization).
1. Click the **Log in with Google** button located under the
**Login** button and **Forgot your password?** link.
* Ask your organization administrators for your Zulip URL.
![Zulip log in Google](/static/images/help/login-with-google.png)
### I signed up with Google/GitHub auth and never set a password
2. If you are not signed into a Google account, Google will ask you to
enter the credentials to your Google account.
If you signed up using passwordless authentication and want to start logging
in via email/password, you can
[reset your password](/help/change-your-password).
![Zulip log in Google login](/static/images/help/google-login.png)
### I forgot my password
3. If you're logging into Zulip with a Google account for the first
time, you will be taken to a page titled **Request for
permission**.
![Zulip log in Google Request Permission](/static/images/help/google-request.png)
Zulip requires knowledge of your email address and basic profile
info, such as your name, for login purposes.
4. Click the **Allow** button to finish your Google login.
If you click the **Deny** button, Zulip cannot finish logging you
in, and you will be redirected to the Zulip login page.
## Logging in with your GitHub account
If your organization has enabled GitHub authentication, you can log into
Zulip using your GitHub account by following a few simple steps.
1. Click the **Log in with GitHub** button located under the **Log in with Google** button.
![Zulip log in GitHub](/static/images/help/login-with-github.png)
2. If you are not logged into a GitHub account, GitHub will ask you to
enter the credentials for your GitHub account.
![Zulip log in GitHub login](/static/images/help/github-login.png)
3. If you're logging into Zulip with a GitHub account for the first
time, you will be taken to a page titled **Authorize application**.
![Zulip log in GitHub Request Permission](/static/images/help/github-request.png)
Zulip requires user data such as your email address and name for login purposes.
4. Click the green **Authorize application** button to finish your GitHub login.
You can [reset your password](/help/change-your-password). This requires
access to the email address you currently have on file. We recommend
[keeping your email address up to date](change-your-email-address).