---
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

---

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