> ## Documentation Index
> Fetch the complete documentation index at: https://infisical-devin-1781641701-docs-github-pat-fine-grained.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Secret Sharing

> Learn how to share time & view-count bound secrets securely with anyone on the internet.

Developers frequently need to share secrets with team members, contractors, or other third parties, which can be risky due to potential leaks or misuse.
Infisical offers a secure solution for sharing secrets over the internet in a time and view-count bound manner. It is possible to share secrets without signing up via [share.infisical.com](https://share.infisical.com) or via Infisical Dashboard (which has more advanced functionality).

## Sharing a Secret

<Steps>
  <Step title="Navigate to the 'Secret Sharing' page and click 'Share Secret'">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/overview.png" alt="Secret Sharing" />
  </Step>

  <Step title="Configure Secret Share">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/create-new-secret.png" alt="Configure Secret" />

    * **Name (optional):** A friendly name for the shared secret.

    * **Your Secret:** The secret content.

    * **Password (optional):** A password which will be required when viewing the secret.

    * **Limit access to people within organization:** Only lets people within your organization view the secret. Enabling this feature requires secret viewers to log into Infisical.

    * **Expires In:** The time it'll take for the secret to expire.

    * **Max Views:** How many times the secret can be viewed before it's destroyed.

    * **Emails (optional):** Email addresses to share the secret with. Each recipient will receive the shared secret link in their inbox after creation. When the "Allow external recipients" toggle is off, only organization member emails are accepted and recipients must have an Infisical account to verify their identity.

    * **Allow external recipients (optional):** When enabled, any email address can be added as a recipient — Even users that don't have an infisical account. A password becomes mandatory in this case. All recipients (including external ones) will receive the secret link via email and must use the password to access the secret. This toggle is automatically disabled when "Limit access to people within organization" is enabled.
  </Step>

  <Step title="Copy Link and Share Secret">
    After creating the shared secret, its link will be displayed. Share this with the intended recipients.

    <Info>
      If no organization or email restrictions are set, anyone with this link can view the secret before it expires.
    </Info>

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/copy-url.png" alt="Copy URL" />
  </Step>

  <Step title="Access Shared Secret">
    Visiting the secret link will display its contents.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/public-view.png" alt="Access Shared Secret" />
  </Step>
</Steps>

## Deleting a Shared Secret

To delete a shared secret, click the **Trash Can** icon on the relevant shared secret row in the [**Secret Sharing**](https://app.infisical.com/organization/secret-sharing?selectedTab=share-secret) page.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/delete-secret.png" alt="Delete Secret" />

## Requesting a Secret

<Steps>
  <Step title="Navigate to the 'Secret Sharing' page under the 'Request Secrets' tab and click 'Request Secret'">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/request-secrets-overview.png" alt="Request Secrets Overview" />
  </Step>

  <Step title="Configure Secret Request">
    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/create-new-request.png" alt="Configure Request" />

    * **Name (optional):** A friendly name for the secret request.
    * **Expires In:** The time it'll take for the request to expire.
    * **General Access:** Who can see the request. (e.g., Everyone, Organization Members)
  </Step>

  <Step title="Copy Link and Share Request">
    After creating the secret request, its link will be displayed. Share this with the intended recipients.

    <Info>
      If no access restrictions are set, anyone with this link can view the request before it expires.
    </Info>

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/request-copy-url.png" alt="Copy Request URL" />
  </Step>

  <Step title="Access Secret Request">
    Visiting the secret request link will display a page for secret input.

    <img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/request-secret-page.png" alt="Request Secret Page" />
  </Step>
</Steps>

## Custom Branding

<Info>
  Custom branding for shared secret pages is a paid feature.

  If you're using Infisical Cloud, then it is available under the **Enterprise Tier**. If you're self-hosting Infisical, then you should contact [sales@infisical.com](mailto:sales@infisical.com) to purchase an enterprise license to use it.
</Info>

You can customize the branding of your shared secret pages and secret request pages by providing your own logo and colors.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/custom-branding-settings.png" alt="Custom Branding Settings" />

If custom branding is added, the shared secret page will display your custom logo and colors without any information about Infisical.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/infisical-devin-1781641701-docs-github-pat-fine-grained/images/platform/secret-sharing/custom-view.png" alt="Custom View" />

## FAQ

<AccordionGroup>
  <Accordion title="Can secrets be changed after they are shared?">
    No, secrets cannot be changed after they've been created. This is to ensure
    that secrets are not tampered with.
  </Accordion>
</AccordionGroup>
