---
title: "Test OIDC connection."
method: POST
path: "/security/oidc/test"
tags: ["oidc"]
---

# Test OIDC connection.

`POST /security/oidc/test`

Tests connectivity to an OIDC provider by fetching its discovery document. Returns the provider's endpoints if successful.

## Request body

- OIDCTestRequest
  - `issuer` string, required — OIDC provider issuer URL to test

## Response `200`

Connection successful

- OIDCTestResponse — OIDC connection test result
  - `success` boolean
  - `issuer` string — Issuer from discovery document
  - `authorization_endpoint` string — OAuth authorization endpoint
  - `token_endpoint` string — OAuth token endpoint
  - `userinfo_endpoint` string — OIDC userinfo endpoint
  - `jwks_uri` string — JSON Web Key Set URI

## Other responses

- `400` — Invalid request
- `401` — Unauthorized - admin access required
- `502` — Failed to connect to OIDC provider

## Changes

- **2026-07-17** `9c4fd7143750` — 1 info
  - endpoint added
- **2022-11-07** `c46a2d6b426c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/signalk/apis/signal-k-security-api/changes/security/oidc/test/post.md)

---

[API](https://skmtc.dev/signalk/apis/signal-k-security-api.md) · [All operations](https://skmtc.dev/signalk/apis/signal-k-security-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalk/signal-k-security-api/revisions/9c4fd7143750/schema)