> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proofpoint Security Awareness Training

> Connect Proofpoint SAT to import phishing simulation and training data.

export const ConnectInPlatform = ({tile, children}) => <Step title="Enter the credentials in the Living Security Platform">
    <p>
      Completed by whoever holds Living Security access — the program owner, or the system
      admin if they've been invited (delegated setup).
    </p>
    <ol>
      <li>
        Go to <strong>Settings → Integrations → Catalog</strong>, find the{' '}
        <strong>{tile}</strong> tile, click <strong>Connect</strong>.
      </li>
      <li>
        Fill in the fields below, then click <strong>Connect</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>This guide is for your {system} administrator.</strong> It covers creating API
      credentials inside {system}, which requires admin access to {system} — not to the
      Living Security Platform.
    </p>
    <p>
      If you're the Living Security <strong>program owner</strong> and don't administer {system},
      send this page to whoever does. They complete Part A and hand the credentials back to you
      (or enter them directly if you've invited them into the platform).
      {recommendDelegated && <>
          {' '}Because setup produces sensitive key material, we recommend the{' '}
          <strong>delegated setup</strong> path so the secret is never sent back to you.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Proofpoint SAT" />

## What Living Security needs

| Credential                | Description                                              |
| ------------------------- | -------------------------------------------------------- |
| **API token**             | An access token generated from the Proofpoint SAT portal |
| **Regional results host** | The hostname for your Proofpoint SAT environment         |

**Scopes:** Access to Phishing (ThreatSim) and PhishAlarm reporting endpoints

**Required role:** **Super Admin**, **Reporting Admin**, or **Reporting API** in Proofpoint SAT

### Prerequisites

* You must have **Super Admin** or **Reporting Admin** access in Proofpoint SAT to generate API tokens.
* The token must be associated with an account that holds one of the required roles.

***

## Part A — In Proofpoint SAT

*Your Proofpoint SAT administrator completes these steps.*

<Steps>
  <Step title="Navigate to API Token settings">
    1. Sign in to your Proofpoint Security Awareness Training portal.
    2. Click your account name or admin menu in the upper right and select **Settings**.
    3. In the left navigation, locate **Integrations** or **API** and open the **Results API** or **Token Mart** page.

    <Note>
      The exact navigation path varies by portal version. If you do not see a **Token Mart** or **Results API** option, contact your Proofpoint administrator — token generation may require a platform feature to be enabled.
    </Note>
  </Step>

  <Step title="Generate a new API token">
    1. Click **Generate Token** (or **Create New Token**).
    2. Enter a descriptive name (e.g., `Living Security Platform`).
    3. Select the appropriate role or access level:

    | Role                | Description                                             |
    | ------------------- | ------------------------------------------------------- |
    | **Super Admin**     | Full platform access including all reporting endpoints  |
    | **Reporting Admin** | Read access to all reporting endpoints                  |
    | **Reporting API**   | Least-privilege role scoped to reporting endpoints only |

    <Note>
      **Least-privilege recommendation:** Use the **Reporting API** role if available. This restricts the token to read-only reporting access.
    </Note>

    4. Save the token.
  </Step>

  <Step title="Copy and save your token">
    **Copy the token immediately** and store it securely.

    <Warning>
      The token may only be displayed once at creation time. If you navigate away without copying it, you may need to revoke and regenerate.
    </Warning>
  </Step>

  <Step title="Identify your regional results host">
    Select the host that matches your Proofpoint SAT environment:

    | Region | Regional results host              |
    | ------ | ---------------------------------- |
    | US     | `results.us.securityeducation.com` |
    | EU     | `results.eu.securityeducation.com` |
    | AP     | `results.ap.securityeducation.com` |

    Enter the **host only** — no `https://` prefix and no trailing slash.
  </Step>
</Steps>

***

## Part B — In the Living Security Platform

*The program owner completes this step, or the system admin if using delegated setup.*

<Steps>
  <ConnectInPlatform tile="Proofpoint Security Awareness Training">
    | Field                     | Value                                                                         |
    | ------------------------- | ----------------------------------------------------------------------------- |
    | **API key**               | The token from Part A, Step 3                                                 |
    | **Regional results host** | The host from Part A, Step 4 (US default: `results.us.securityeducation.com`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/proofpoint-security-awareness-training/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=2a8ddf5dd1a87b272d876b0ba4569fec" alt="Living Security connect dialog for Proofpoint SAT" style={{maxWidth: "450px"}} width="576" height="372" data-path="integrations/images/proofpoint-security-awareness-training/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

You are now connected to Proofpoint Security Awareness Training.

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    The token is invalid or expired. Verify that:

    1. Token is correct and has not been revoked
    2. Token was generated with proper role access
  </Accordion>

  <Accordion title="403 Forbidden">
    The token lacks access to the required reporting endpoints. Verify the token was created with **Super Admin**, **Reporting Admin**, or **Reporting API** role.
  </Accordion>

  <Accordion title="Wrong regional host">
    Data syncs will fail if the regional host doesn't match your SAT environment. Verify:

    * US accounts use `results.us.securityeducation.com`
    * EU accounts use `results.eu.securityeducation.com`
    * AP accounts use `results.ap.securityeducation.com`
  </Accordion>

  <Accordion title="Token generation not available">
    If you don't see the Token Mart or Results API option in settings, the feature may not be enabled for your account. Contact your Proofpoint administrator or Customer Success Manager.
  </Accordion>
</AccordionGroup>