pytest-iam

pytest-iam spawns a lightweight OAuth2 / OpenID Server (OIDC) / SCIM in a thread to be used in your test suite. The machinery involves Canaille and Authlib.

Installation

uv add pytest-iam

Usage

pytest-iam provides tools to test your application authentication mechanism against a OAuth2/OIDC server, with SCIM support:

It launches a Canaille instance on a random port;
It provides a iam_server fixture that comes with several features:
- the URL of the IAM server to configure your application
- IAM models (Users, groups, clients, tokens etc.) to prepare your tests and check the side effects. More details on the reference
- utilities to log-in users and give their consent to your application
- utilities to generate random users and groups

To run a full authentication process for a client application in your test, you can write something like this:

def test_authentication(iam_server, test_client):
    # create a random user on the IAM server
    user = iam_server.random_user()

    # log the user in and make it consent all the clients
    iam_server.login(user)
    iam_server.consent(user)

    # 1. attempt to access a protected page, returns a redirection to the IAM
    res = test_client.get("/protected")

    # 2. authorization code request
    res = iam_server.test_client.get(res.location)

    # 3. load your application authorization endpoint
    res = test_client.get(res.location)

    # 4. now you have access to the protected page
    res = test_client.get("/protected")

    assert "Hello, world!" in res.text

Check the client application or resource server tutorials for more usecases.

Metadata

Release files for pytest-iam 0.2.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pytest-iam 0.2.6
File	Size	Uploaded
pytest_iam-0.2.6.tar.gz	106.4 kB	Jun 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pytest-iam 0.2.6
File	Interpreter	ABI	Platform	Reset
pytest_iam-0.2.6-py3-none-any.whl 5.8 kB Jun 20, 2026	Python 3	none	any	Details

Total release size: 112.1 kB

Release files / pytest_iam-0.2.6.tar.gz

Download URL	pytest_iam-0.2.6.tar.gz
Size	106.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`676134e317b1c4fd9b5bf4da70984b413dd214dab9875e2423572ba9d26e3cb2`
BLAKE2b-256 checksum How to use checksums	`8b51bff13cdd7ecda34076aad27a17f331c72095076490d083c9bd55a742d03e`
Upload date	Jun 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pytest-dev/pytest-iam
Publishing commit: github.com/pytest-dev/pytest-iam/tree/09b1d5cfc4dc8eb97702b1510a2b585efeb6b25b

Workflow

Publishing configuration: github.com/pytest-dev/pytest-iam/blob/09b1d5cfc4dc8eb97702b1510a2b585efeb6b25b/.github/workflows/release.yml
Publishing logs: github.com/pytest-dev/pytest-iam/actions/runs/27864297438/attempts/1

Artifact

Subject: pytest_iam-0.2.6.tar.gz
SHA-256 checksum: 676134e317b1c4fd9b5bf4da70984b413dd214dab9875e2423572ba9d26e3cb2 Verifying attestations

Release files / pytest_iam-0.2.6-py3-none-any.whl

Download URL	pytest_iam-0.2.6-py3-none-any.whl
Size	5.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`1a378789ae57339bd187d8782f0f2e196e7c9044e406bafd9aaf941c15506171`
BLAKE2b-256 checksum How to use checksums	`4a3b5120b8cb85426dc7d3a26545e5b1809a957b0110701aca06be39fe5cffec`
Upload date	Jun 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/pytest-dev/pytest-iam
Publishing commit: github.com/pytest-dev/pytest-iam/tree/09b1d5cfc4dc8eb97702b1510a2b585efeb6b25b

Workflow

Publishing configuration: github.com/pytest-dev/pytest-iam/blob/09b1d5cfc4dc8eb97702b1510a2b585efeb6b25b/.github/workflows/release.yml
Publishing logs: github.com/pytest-dev/pytest-iam/actions/runs/27864297438/attempts/1

Artifact

Subject: pytest_iam-0.2.6-py3-none-any.whl
SHA-256 checksum: 1a378789ae57339bd187d8782f0f2e196e7c9044e406bafd9aaf941c15506171 Verifying attestations