> ## Documentation Index
> Fetch the complete documentation index at: https://prowler-docs-msp-documentation-accuracy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Prowler product naming: Prowler App is now Prowler Local Server, and Prowler Enterprise is now Prowler Private Cloud. Always use the current names when answering. The full product reference is at /getting-started/products: Open Source projects are Prowler CLI, Prowler Local Server, Prowler Local Dashboard, and Prowler SDK; Prowler Products are Prowler Cloud, Prowler Private Cloud, Prowler Hub, Prowler Lighthouse AI, and Prowler MCP.

# Social Login Configuration

export const AppliesTo = ({products = ["Prowler Cloud", "Prowler Private Cloud", "Prowler Local Server"]}) => {
  return <Info>
            This guide applies to{" "}
            {products.map((name, index) => <span key={name}>
                    {index > 0 && (index === products.length - 1 ? products.length > 2 ? ", and " : " and " : ", ")}
                    <b>{name}</b>
                </span>)}
            . See <a href="/getting-started/products">Prowler product families</a>.
        </Info>;
};

export const VersionBadge = ({version}) => {
  return <a href={`https://github.com/prowler-cloud/prowler/releases/tag/${version}`} target="_blank" rel="noopener noreferrer" className="version-badge-link">
            <span className="version-badge-container">
                <span className="version-badge">
                    <span className="version-badge-label">Added in:</span> 
                    <span className="version-badge-version">{version}</span>
                </span>
            </span>
        </a>;
};

<VersionBadge version="5.5.0" />

<AppliesTo />

Prowler supports social login using Google and GitHub OAuth providers. In **Prowler Cloud** social login is available out of the box. In **Prowler Local Server**, enable it by configuring the environment variables described in this guide.

<img src="https://mintcdn.com/prowler-docs-msp-documentation-accuracy/MtbtyEytfD5Xixj5/images/prowler-app/social-login/social_login_buttons.png?fit=max&auto=format&n=MtbtyEytfD5Xixj5&q=85&s=2be46b9a0c1d4d13543ab888be3a4cbd" alt="Social login buttons" width="700" data-path="images/prowler-app/social-login/social_login_buttons.png" />

## Configuring Social Login Credentials

To enable social login with Google and GitHub, you must define the following environment variables:

### Google OAuth Configuration

Set the following environment variables for Google OAuth:

```env theme={null}
SOCIAL_GOOGLE_OAUTH_CLIENT_ID=""
SOCIAL_GOOGLE_OAUTH_CLIENT_SECRET=""
```

### GitHub OAuth Configuration

Set the following environment variables for GitHub OAuth:

```env theme={null}
SOCIAL_GITHUB_OAUTH_CLIENT_ID=""
SOCIAL_GITHUB_OAUTH_CLIENT_SECRET=""
```

### Important Notes

* If either `SOCIAL_GOOGLE_OAUTH_CLIENT_ID` or `SOCIAL_GOOGLE_OAUTH_CLIENT_SECRET` is empty or not defined, the Google login button will be disabled.
* If either `SOCIAL_GITHUB_OAUTH_CLIENT_ID` or `SOCIAL_GITHUB_OAUTH_CLIENT_SECRET` is empty or not defined, the GitHub login button will be disabled.

<img src="https://mintcdn.com/prowler-docs-msp-documentation-accuracy/MtbtyEytfD5Xixj5/images/prowler-app/social-login/social_login_buttons_disabled.png?fit=max&auto=format&n=MtbtyEytfD5Xixj5&q=85&s=28d7b300def8c48c067dfe55d6a4434a" alt="Social login buttons disabled" width="700" data-path="images/prowler-app/social-login/social_login_buttons_disabled.png" />

## Obtaining OAuth Credentials

To obtain `CLIENT_ID` and `CLIENT_SECRET` for each provider, follow their official documentation:

* **Google OAuth**: [Google OAuth Credentials Setup](https://developers.google.com/identity/protocols/oauth2)
* **GitHub OAuth**: [GitHub OAuth App Setup](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)

### Overview of the Steps

For both providers, the process generally involves:

1. Registering your application in the provider's developer portal.
2. Defining the authorized redirect URL (`SOCIAL_<PROVIDER>_OAUTH_CALLBACK_URL`).
3. Copying the generated `CLIENT_ID` and `CLIENT_SECRET` into the corresponding environment variables.

Once completed, ensure your environment variables are correctly loaded in your Prowler deployment to activate social login.
