> For the complete documentation index, see [llms.txt](https://hub.equipme.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hub.equipme.io/classes/portal-quick-setup/portal-registration/direct-login-with-single-sign-on.md).

# Direct login with single sign on

Organizations that use single sign on often have a clearly defined login method for their users. In these cases, users do not need to choose between different login options before accessing equipme.

Direct SSO login links can be used to send users straight to the correct login flow.

Instead of opening equipme first and selecting a login method manually, the link already includes the selected single sign on provider.

For example:

`https://app.equipme.io/sso?provider=microsoft`

This link starts the login process directly with Microsoft as the single sign on provider.

### When to use direct SSO login links

Direct SSO login links are useful when users access equipme from another system or communication channel.

Common examples include internal help pages, intranet pages, onboarding instructions, customer communications or other systems that link users back to equipme.

In these situations, the login method is usually already known. The direct login link gives users a clear entry point and guides them into the correct authentication flow.

### Benefits for users

Direct SSO login links reduce the number of decisions users need to make during login.

Users do not have to select a provider manually. They can access equipme through the login method that already matches their company setup.

This makes the entry into equipme clearer, especially for users who only access equipme through internal links or predefined workflows.

### Benefits for admins and partners

Admins and partners can use direct SSO login links wherever they want to guide users into equipme from a specific context.

This can make internal documentation, support instructions and customer communication easier to follow, because the link already points to the intended login path.

Direct SSO login links are therefore a simple way to create a more guided access experience for users.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://hub.equipme.io/classes/portal-quick-setup/portal-registration/direct-login-with-single-sign-on.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
