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

# Intranet on SharePoint

> Put an agent on a SharePoint Online intranet with silent single sign-on.

# Intranet on SharePoint

An agent embedded across a SharePoint Online intranet, signing employees in
**silently** through Microsoft 365 so it answers each person personally — no
second login, no `<script>` tag to paste.

## What you'll connect

| Piece        | Choice                                                                          | Why                                               |
| ------------ | ------------------------------------------------------------------------------- | ------------------------------------------------- |
| Channel      | [Web widget](/channels/web-widget) → [SharePoint package](/channels/sharepoint) | The supported way onto modern SharePoint          |
| Identity     | Federated (Microsoft 365) SSO                                                   | Silent sign-in for logged-in employees            |
| Integrations | Whatever the agent needs                                                        | e.g. SharePoint/OneDrive, an HRIS, a service desk |

## Build it

<Steps>
  <Step title="Create the agent and a web-widget channel">
    Build the agent as usual, then add a [web widget](/channels/web-widget)
    channel — SharePoint deploys the same widget.
  </Step>

  <Step title="Deploy the SharePoint package">
    Follow the [SharePoint guide](/channels/sharepoint) end to end: install the
    package, add the widget host as a **Trusted Script Source**, and add the
    agent to a page or site-wide. Use the production widget host
    (`https://widget.cobalt.peoplereign.io`).
  </Step>

  <Step title="Turn on silent SSO">
    Configure the channel's **federated identity** so the SharePoint package's
    Microsoft token signs employees in silently. The guide covers the admin
    consent and the claim configuration.
  </Step>

  <Step title="Connect the agent's integrations">
    Add whatever the agent needs from the [catalog](/integrations/catalog). With
    SSO in place, reads run as the signed-in employee.
  </Step>
</Steps>

## Notes

* SharePoint is the one channel where the plain embed snippet won't work —
  modern SharePoint blocks it, which is exactly why the package exists.
* The current package (v1.0.2) defaults the widget source to Cobalt's dev host;
  set it explicitly to the production host, as the
  [SharePoint guide](/channels/sharepoint) calls out.
