# Security

At Rails, the security of your account is our top priority. This section details how to secure or regain access to your account. Click the links below to jump to some common security topics:

<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Password Reset</strong></td><td><a href="/pages/mJIamY2bzqDKgII5GZXk#password-reset">/pages/mJIamY2bzqDKgII5GZXk#password-reset</a></td></tr><tr><td align="center"><p><strong>Multi-Factor Authentication (MFA)</strong></p><p><br></p></td><td><a href="/pages/mJIamY2bzqDKgII5GZXk#multi-factor-authentication-mfa">/pages/mJIamY2bzqDKgII5GZXk#multi-factor-authentication-mfa</a></td></tr><tr><td align="center"><strong>Single Sign-on (SSO) with Google</strong></td><td><a href="/pages/mJIamY2bzqDKgII5GZXk#single-sign-on-sso-with-google">/pages/mJIamY2bzqDKgII5GZXk#single-sign-on-sso-with-google</a></td></tr></tbody></table>

{% hint style="danger" %}
If you have urgent login issues, please contact us via [email](https://railsxyz.zendesk.com/hc/en-us/requests/new).
{% endhint %}

## Password Reset

For your security, we recommend updating your password regularly. You can change it proactively at any time, either from your account settings while logged in, or from the login screen if you’ve forgotten it.

Click the expandable sections below to see detailed instructions for each method.

<details>

<summary>Reset from <strong>Login Screen</strong> </summary>

1. Go to the [login page](https://trade.rails.xyz/trade/BTC-USD).
2. Click on **Forgot Password:**<br>

   <figure><img src="/files/fZ7aegQ6YrbjsXXpUR4T" alt=""><figcaption></figcaption></figure>
3. Insert the email associated with your account and click **Next**.<br>

   <figure><img src="/files/mhbt8B2qMxNDtTEoxoQ5" alt=""><figcaption></figcaption></figure>
4. Check your email for instructions on resetting your password. <br>

   <figure><img src="/files/mTPM2JAWw0Mze5RbU530" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
If you do not receive a Password Reset email within 5 minutes, check your spam folder or follow these [troubleshooting tips](/support/troubleshooting-tips.md#email-not-received).
{% endhint %}

5. Click on **Reset your password** in the email.

<figure><img src="/files/S42IZUuY6oA00UXmhFyo" alt="" width="375"><figcaption></figcaption></figure>

6. Type in your new password and confirm it in the fields provided and click **Next**.<br>

   <figure><img src="/files/E9kzQ3uJknwkNkNVHqNB" alt=""><figcaption></figcaption></figure>

Once successfully changed, you can use your new password to Sign in.

<figure><img src="/files/Rd0vmAbKA8YXPheFMUVJ" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary>Reset from <strong>Settings</strong></summary>

1. [Login](https://trade.rails.xyz/trade/BTC-USD) to your Rails account.
2. Click on the **Options button** (Username) on the top right corner and then select **Settings**.

<figure><img src="/files/NNTHqI6ko0Zpvr5ZbCJV" alt="" width="563"><figcaption></figcaption></figure>

\
You will automatically be directed to the ***Change Password*** section of the Security page.&#x20;

3. Input your new password in the **New Password** field.&#x20;
4. Re-enter your new password in the **Confirm Password** to confirm it’s accurate.

<figure><img src="/files/2R7HvJwN8c8PXk72MqKn" alt="" width="375"><figcaption></figcaption></figure>

3. Click **Update Password**.

</details>

## Multi-Factor Authentication (MFA)

Multi-Factor Authentication (MFA) adds an extra layer of protection to your login process by requiring more than just your password. With MFA enabled, you’ll be asked to verify your identity using an additional factor from the following options:

**One-Time Passcode (OTP)**

An OTP is a short, temporary security code we email you before you sign in. Each OTP is valid for a single use and expires within 10 minutes, helping to ensure that only you can access your account.

<details>

<summary>Setting up OTP</summary>

Complete the following steps to set up an OTP on your account:

1. Click on the **Options button** (your username) on the top right of the trading page, then click **Settings**.

<figure><img src="/files/NNTHqI6ko0Zpvr5ZbCJV" alt="" width="563"><figcaption></figcaption></figure>

2. You will automatically be directed to the Security page. Select **Multi-Factor Authentication**.

<figure><img src="/files/mR6OurcOh27rt7KSV2Kl" alt="" width="563"><figcaption></figcaption></figure>

3. Click the **toggle switch** to enable OTP. It will move to the right and become blue when enabled.

<figure><img src="/files/96qBMRvLohI41xYunPOa" alt="" width="563"><figcaption></figcaption></figure>

If you wish to disable OTP at any point, click the toggle switch again until it is left aligned.&#x20;

</details>

<details>

<summary>Signing in using OTP</summary>

1. Go to the [login page](https://trade.rails.xyz/trade/BTC-USD).

{% hint style="info" %}
You will not be asked to complete OTP if you [Sign in with Google](#single-sign-on-sso-with-google), even if it's enabled.
{% endhint %}

2. Input your email and password and click **Sign In.**<br>

   <figure><img src="/files/bauXuRoKRPWpm3UQPMlW" alt=""><figcaption></figcaption></figure>
3. If you have both OTP and passkeys enabled, you will be prompted to select between the two verification methods. Ensure the OTP option is selected then click **Sign In**.

<figure><img src="/files/BknOcuUeFfxq7cEYewY1" alt="" width="375"><figcaption></figcaption></figure>

4. You will be prompted to input the code. Check your email for a unique passcode as displayed below.

<figure><img src="/files/CfUngjge9rpbAwy6xKuy" alt="" width="375"><figcaption></figcaption></figure>

5. Navigate back to the sign in screen, input the code and click **Sign in**.<br>

   <figure><img src="/files/s17lIDaQrsFok9GAF4IA" alt=""><figcaption></figcaption></figure>

If successful, you will be directed to Rails' main trading page.&#x20;

{% hint style="warning" %}
Check out our [troubleshooting tips](/support/troubleshooting-tips.md#sign-up-and-security) if you are having trouble logging in.
{% endhint %}

</details>

**Passkey**

Passkeys are secure digital credentials stored on your device, offering an extra security layer for your account. They use advanced encryption and biometric verification (e.g., Face ID, fingerprint) or a device PIN for quick and secure identity verification. Physical security keys like YubiKey can also be used as passkeys to enhance security.

<details>

<summary>Setting up a Passkey</summary>

1. Click on the **Options button** (your username) on the top right of the trading page, then click **Settings**.

<figure><img src="/files/NNTHqI6ko0Zpvr5ZbCJV" alt="" width="563"><figcaption></figcaption></figure>

2. You will automatically be directed to the Security page. Select **Multi-Factor Authentication**.

<figure><img src="/files/mR6OurcOh27rt7KSV2Kl" alt="" width="563"><figcaption></figcaption></figure>

3. Click on **Create Passkey.**

<figure><img src="/files/vfJD1Jve0DI8L5o4LuTR" alt="" width="563"><figcaption></figcaption></figure>

4. Your device may suggest a specific passkey method (e.g. 1Password, iCloud, etc.) based on what you have available. Follow the prompts to set up the suggested passkey, or click **X** or **Cancel** until you get a screen similar to the below screenshot to select your preferred passkey method. &#x20;

<figure><img src="/files/epQjkrlGgrihaXaPp7Fj" alt=""><figcaption></figcaption></figure>

5. Follow the verification prompts on your device, or jump to [supported passkeys](#supported-passkeys) to see steps for specific, common passkeys.
6. Once completed, you should see your passkey listed in your settings page as shown below.&#x20;

<figure><img src="/files/pMj5x0vZJ1lNPPeskSI9" alt=""><figcaption></figcaption></figure>

5. Ensure the toggle for **Passkeys** is on. It will be blue and switched to the right.

<figure><img src="/files/AdiEBCYSCN7EQoDQBILk" alt=""><figcaption></figcaption></figure>

To add additional passkeys, simply click the **Add Passkey** button in the bottom left corner and repeat this process.&#x20;

<figure><img src="/files/STdWp197ZwnvWNFuZRtb" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
Edit your passkey names for easier identification by clicking the pencil icon  <img src="/files/HDQiwSRfEvC1qGxf1KsA" alt="" data-size="line"> in the Action column.
{% endhint %}

</details>

<details>

<summary>Signing in using Passkeys</summary>

1. Go to the [login page](https://trade.rails.xyz/trade/BTC-USD).

{% hint style="info" %}
You will not be asked to verify via passkey if you [Sign in with Google](#single-sign-on-sso-with-google), even if it's enabled.
{% endhint %}

2. Input your email and password and click **Sign In.**

<figure><img src="/files/bauXuRoKRPWpm3UQPMlW" alt=""><figcaption></figcaption></figure>

3. If you have both OTP and passkeys enabled, you will be prompted to select between the two verification methods. Ensure **Sign in with a passkey** is selected then click **Sign In**.&#x20;

<figure><img src="/files/BknOcuUeFfxq7cEYewY1" alt="" width="375"><figcaption></figcaption></figure>

4. Follow the prompts on your passkey. If successful, you will be directed to Rails' main trading page.&#x20;

{% hint style="warning" %}
Check out our [troubleshooting tips](/support/troubleshooting-tips.md#sign-up-and-security) if you are having trouble logging in.
{% endhint %}

</details>

{% hint style="warning" %}
MFA does not apply to [Single Sign-on with Google](#single-sign-on-sso-with-google). Users will only be prompted to complete MFA when signing in with their login and password.
{% endhint %}

### Supported Passkeys

Rails supports a broad list of secure FIDO2-based passkeys for MFA. FIDO2 passkeys are secure digital credentials stored directly on your device. They use cryptographic keys paired with biometric verification (like fingerprint or facial recognition) or a PIN. Because passkeys are device-bound, they’re significantly more resistant to common cyber threats like phishing, credential theft, and password reuse attacks.

Click the expandable sections below to see step-by-step instructions on how to setup some of the most common passkeys.&#x20;

#### Setting up Common Passkeys

If you have multiple passkey options on your device, it will decide the hierarchy of which one you are presented with first. Click **X** or **Cancel** when prompted if you wish to use or setup a different passkey.

<details>

<summary>iCloud Keychain</summary>

Mac users that utilize biometric (fingerprint) scan set up access to their passkey by using the following steps:

1. Your device may prompt you to setup a different passkey (e.g. Chrome, 1Password, etc.) proactively. Click **X** or **Cancel** until you get to the following screen, then select **iCloud Keychain**.

<figure><img src="/files/jBA3FTZitrjMyAcUkLrG" alt="" width="563"><figcaption></figcaption></figure>

2. Use your fingerprint to allow for a passkey to be saved on your iCloud Keychain.

<figure><img src="/files/O8yAcWXIOKmu35iT3ua7" alt="" width="563"><figcaption></figcaption></figure>

3. If saved successfully, this passkey will be saved in your security settings under passkeys as *iCloud Keychain*.

<figure><img src="/files/zuHw5Q1tQceTE21TixYO" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Click the pencil icon to edit the passkey name if you're adding multiple passkeys or devices.
{% endhint %}

</details>

<details>

<summary>1Password</summary>

Users who have the 1Password browser extension are able to use their 1Password account to securely store their passkey by following these steps:

1. Unlock your 1Password account (if prompted).

<figure><img src="/files/akze7T3tLj5oGqg3Vx8R" alt="" width="563"><figcaption></figcaption></figure>

2. Click New Item on the 1Password prompt and then click Save.

<figure><img src="/files/17EYgW9HNzYMmZRGlsm8" alt="" width="563"><figcaption></figcaption></figure>

2. Your passkey is automatically created in 1Password and if successful, it will be listed in Settings > Security > MFA > Passkeys as *1Password*.

<figure><img src="/files/OfgA0t1PIvMQ0sOaulSl" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Click the pencil icon to edit the passkey name if you're adding multiple passkeys or devices.
{% endhint %}

</details>

<details>

<summary>Chrome Profile</summary>

Users who have biometrics setup in their Chrome browser can also use this as a passkey method.

1. Your device may prompt you to setup a different passkey (e.g. iCloud, 1Password, etc.) proactively. Click **X** or **Cancel** until you get to the following screen, then select **Your Chrome profile**.

<figure><img src="/files/qasLetFprRNeSr72w6QY" alt="" width="563"><figcaption></figcaption></figure>

2. Ensure the right profile is selected and click **Continue.**

<figure><img src="/files/NWgKiu3fA9jjxbBUuSI2" alt="" width="563"><figcaption></figcaption></figure>

3. Provide biometric scan or password to continue.

<figure><img src="/files/iV3CKXET5mMlGP7rf21O" alt=""><figcaption></figcaption></figure>

4. If saved successfully, this passkey will be saved in Settings > Security > MFA > Passkeys. as *Chrome on Mac.*

<figure><img src="/files/8a1pugKbb5WHlk1fXA1a" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Click the pencil icon to edit the passkey name if you're adding multiple passkeys or devices.
{% endhint %}

</details>

<details>

<summary>Device QR Code or Security Key</summary>

Users are able to access their passkey by using another device or private security key by using the following steps:

1. Your device may prompt you to setup a different passkey (e.g. iCloud, 1Password, etc.) proactively. Click **X** or **Cancel** until you get to the following screen, then select **Use phone, tablet or Security Key**

<figure><img src="/files/W3bTILPyUUQNK94L39c0" alt="" width="563"><figcaption></figcaption></figure>

2. When presented with this screen, you can choose to either use a camera on another device  to scan the QR Code or insert and touch your security key to setup the passkey.

<figure><img src="/files/zmvAIpLhfsBrgO3cZsK7" alt="" width="563"><figcaption></figcaption></figure>

3. Follow the prompts on your device.
4. If saved successfully, this passkey will be visible in your passkey list in Settings > Security > MFA > Passkeys.

</details>

## Single Sign-On (SSO) with Google

Single Sign-on (SSO) with Google lets you quickly and securely log into your account using your existing Google credentials. Instead of managing a separate username and password, you simply authenticate through your Google account. This adds convenience, enhanced security and a faster login process.

<details>

<summary>Setting up SSO with Google</summary>

1. Visit the [login page](https://trade.rails.xyz/trade/BTC-USD) and click **Sign in with Google**.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeyKwZS_38TqeblvMkytqZ_qA1pZngLURGSj-I1f-_PhwwPBJRIN0x1p4jcU3yislsTtgnjDDHc6Xydko_Dn8lPdAdc0b8DwjW5t2wiV8nRd2FI17agAOMrJbc5USwolptLvH_X?key=qdVrq1hEBycm30QbGafKtC1q" alt="" width="375"><figcaption></figcaption></figure>

2. Choose the Google account you would like to sign in with.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcbVEFTTf5f_oj4VKEW0SI5tddEQIopSJQ3Y2TWTR4NrBzWusF2au6yRsz4g4oafenDQcHCfW1ztiwQiChhHhSAQbpiQLfARuxq9rjtOxb23MJS81DanZ8bDBAP8kJx?key=qdVrq1hEBycm30QbGafKtC1q" alt="" width="375"><figcaption></figcaption></figure>

3. Click **Continue** on the confirmation screen.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfDopBybBjMnPGR-i50RJ6EUlyyHUrAPynigXFC6o3W4Mjg7dMRSGvjP1TCH1j72m7-PJlTmVxGmh_Rs7niCCUy8wqTw1mjkSj_lqVRcNuyiAOg5_bpqUgMoAGjn3Kvz-e_suY?key=qdVrq1hEBycm30QbGafKtC1q" alt="" width="375"><figcaption></figcaption></figure>

You should now be logged in and navigated to your rails account automatically. If you're having issues, ensure the email is the one associated with your Rails account or checkout our [troubleshooting tips](/support/troubleshooting-tips.md).

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.rails.xyz/general/security.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
