--- title: "Ncloud Single Sign-Onメタデータの照会" slug: "get-sp-metadata" updated: 2026-09-17T09:58:00Z published: 2026-09-17T09:58:00Z canonical: "api.ncloud-docs.com/get-sp-metadata" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Ncloud Single Sign-Onメタデータの照会 Classic/VPC環境で利用できます。 Ncloud Single Sign-Onのメタデータを照会します。 ## リクエスト リクエスト形式を説明します。リクエスト形式は次の通りです。 | メソッド | URI | | --- | --- | | GET | /api/v1/tenant/saml-idp/sp-metadata | ### リクエストヘッダ Ncloud Single Sign-On APIで共通して使用されるヘッダの詳細は、[Ncloud Single Sign-Onのリクエストヘッダ](/docs/ja/single-sign-on-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエスト例 リクエストのサンプルコードは次の通りです。 ``` curl --location --request GET 'https://sso.apigw.ntruss.com/api/v1/tenant/saml-idp/sp-metadata' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスボディ レスポンスボディの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `EntityDescriptor.xmlns:md` | String | - | XML namespace情報 - `urn:oasis:names:tc:SAML:2.0:metadata` (有効値) | | `EntityDescriptor.ID` | String | - | Entity Descriptorの固有 ID | | `EntityDescriptor.entityID` | String | - | SPエンティティの固有 ID | | `EntityDescriptor.SPSSODescriptor.AuthnRequestsSigned` | Boolean | - | AuthnRequestに署名するかどうか - `true` \| `false` - `true`: 署名 - `false`: 署名しない | | `EntityDescriptor.SPSSODescriptor.WantAssertionsSigned` | Boolean | - | Assertionに署名するかどうか - `true` \| `false` - `true`: 署名 - `false`: 署名しない | | `EntityDescriptor.SPSSODescriptor.protocolSupportEnumeration` | String | - | サポートするプロトコル - `urn:oasis:names:tc:SAML:2.0:protocol` (有効値) | | `EntityDescriptor.SPSSODescriptor.KeyDescriptor.use` | String | - | 証明書の用途 - `signing` (有効値) | | `EntityDescriptor.SPSSODescriptor.KeyDescriptor.KeyInfo.xmlns:ds` | String | - | KeyInfo namespace情報 - `http://www.w3.org/2000/09/xmldsig#` (有効値) | | `EntityDescriptor.SPSSODescriptor.KeyDescriptor.KeyInfo.X509Data.X509Certificate` | String | - | IdP署名用 X.509証明書 | | `EntityDescriptor.SPSSODescriptor.NameIDFormat` | String | - | サポートする NameID形式 - `urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress` (有効値) | | `EntityDescriptor.SPSSODescriptor.AssertionConsumerService.Binding` | String | - | SAMLログイン時のプロトコルバインディング情報 - `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST` \| `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect` - `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST`: HTTP-POST方式 - `urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect`: HTTP-Redirect方式 | | `EntityDescriptor.SPSSODescriptor.AssertionConsumerService.Location` | String | - | バインディングプロトコルとマッピングする SAMLログイン URL | | `EntityDescriptor.SPSSODescriptor.AssertionConsumerService.index` | String | - | SAMLログイン時のプロトコルバインディングサービスのインデックス | ### レスポンスステータスコード Ncloud Single Sign-On APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Single Sign-Onのレスポンスステータスコード](/docs/ja/single-sign-on-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 ``` MII******************vkhgLE= urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress ```