Get SSO Metadata (Organization)

Generate SAML/OIDC metadata for the organization to provide to SSO providers.

Quick Navigation

• Endpoint
• Headers
• Query Parameters
• Response
• Success (200)
• Features
• Status

Outline

• Endpoint
• Headers
• Query Parameters
• Response
  • Success (200)
• Features
• Status

Endpoint

GET /api/v1/sso/metadata?provider_id=1&format=xml

Headers

Header	Required	Description
Authorization	Yes	Bearer <access_token>

Query Parameters

Parameter	Type	Required	Description
provider_id	integer	Yes	SSO Provider ID
format	string	No	Metadata format: "xml" or "json" (default: "xml")

Response

Success (200)

{
  "success": true,
  "data": {
    "metadata": "<?xml version=\"1.0\"?><EntityDescriptor>...</EntityDescriptor>",
    "format": "xml",
    "generated_at": "2024-01-01T12:00:00Z",
    "message": "SSO metadata generated successfully"
  },
  "message": "SSO metadata generated successfully"
}

Features

• Metadata generation for SAML/OIDC
• XML and JSON format support
• Certificate information included
• Endpoint URLs (SSO, SLO, etc.)
• Entity ID generation

Status

[WARNING] TODO: Not Implemented

This endpoint schema is defined but the implementation logic is not yet complete. Refer to /openapi.json for planned schema.