# Island.is Authentication Service

Digital Iceland has created the Island.is Authentication Service (IAS) as a modern solution to help government organisations authenticate users online. The service is built on open standards including OAuth2 and Open ID Connect and includes scope-based authorisation functionality to support different kinds of delegations as well as user-based API authorisation across organisational boundaries.

Delegations allow individuals to access digital services on behalf of another individual or legal entities. E.g. guardians can access services on behalf of children they ward, and employees can access services on behalf of the company they work for. Note that with delegations, as opposed to impersonation, each delegated access includes cryptographically signed claims about the actual authenticated user.

This documentation is meant for developers and software architects at Service Providers (SPs) planning to integrate with the IAS. It describes the architecture of the authentication service and how to use it.

A full documentation of Open ID Connect (OIDC) and OAuth2 is outside the scope of this documentation. We recommend reading the following resources before integrating with IAS.

* [Open ID Connect](https://openid.net/connect/)
* [OAuth 2](https://oauth.net/2/)

## Table of contents

* [Terminology](/products/auth/terminology.md)
* [Integration options](/products/auth/integration-options.md)
* [Authentication flows](/products/auth/authentication-flows.md)
* [Authorising API endpoints](/products/auth/authorising-apis.md)
* [Session lifecycle](/products/auth/session-lifecycle.md)
* [Scopes and tokens](/products/auth/scopes-and-tokens.md)
* [Delegations](/products/auth/delegations.md)
* [Configuration](/products/auth/configuration.md)
* [Tools and examples](/products/auth/integration-guidance.md)
* [Environments](/products/auth/environments.md)
* [Test IAS with Postman](/products/auth/postman-test.md)


---

# Agent Instructions: 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:

```
GET https://docs.devland.is/products/auth.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.