Ncloud Single Sign-Onの概要
    • PDF

    Ncloud Single Sign-Onの概要

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    Application/Tenant/External IDP/User/Group/Permission Set/Assignment情報を管理する APIを提供します。
    APIは RESTful API形式で、HTTP GET/POST/PUT/DELETEメソッドを使用します。

    オペレーション

    Ncloud Single Sign-Onは、Application、Tenant、External IDP、User、Group、PermissionSet、Assignmentオペレーションを提供します。

    Application

    Applicationに関連した APIリストは次の通りです。

    API説明
    getApplicationsApplicationリストを照会
    getApplicationApplicationを個別照会
    postApplicationApplicationを作成
    putApplicationApplicationを変更
    deleteApplicationApplicationを削除
    renewalClientSecret(Oauth2) Client Secretを再作成

    Tenant

    Tenantに関連した APIリストは次の通りです。

    API説明
    getTenantTenantを照会
    postTenantTenantを作成
    putTenantTenantを変更
    deleteTenantTenantを削除

    External IDP

    External IDPに関連した APIリストは次の通りです。

    API説明
    postExternalIdPExternal IDPを登録
    getExternalIdPExternal IDPを照会
    deleteExternalIdPExternal IDPを削除
    putExternalIdPExternal IDPを変更
    modifyAttributeMapperAttributeMapperを変更
    getAttributeMapperAttributeMapperを照会
    parseExternalIdpMetadataExternal IDPメタデータをパース
    getSpMetadataNcloud Single Sign-Onメタデータを照会
    getSpUrldataNcloud Single Sign-On URLデータを照会
    putLoginSettingExternal IDPログイン情報を設定
    postOrganizationOrganizationと連携

    User

    Userに関連した APIリストは次の通りです。

    API説明
    validateUserLoginIdUser Login ID有効性検査
    postUserUserを個別作成
    postUsersUserを大量に作成
    putUserUserを変更
    deleteUserUserを削除
    deleteUsersUserリストを削除
    getUserUserを個別照会
    getUsersUserリストを照会
    getUserAccessRuleUser AccessRuleを照会
    putUserAccessRuleUser AccessRuleを変更
    getUserProfileUser Profileを照会
    postUserToGroupUserを Groupに追加
    getUserGroupsUserが属する Groupリストを照会
    getUserGroupUserが属する Groupを個別照会
    deleteUserFromGroupUserを Groupから削除
    changeUserStatusUser状態を変更
    getUserSessionUserセッションを照会
    expireUserSessionUserセッション期限切れ
    getUserAssignmentsUserが属する Assignmentリストを照会
    deleteUserFromAssignmentUserを Assignmentから削除
    addUserMfaDevicesUserに MFA Deviceを追加
    getUserMfaDevicesUserが所有する MFA Deviceを照会
    deleteUserMfaDevicesUserが所有する MFA Deviceを削除

    Group

    Groupに関連した APIリストは次の通りです。

    API説明
    validateGroupNameGroup名の有効性検査
    postGroupGroupを作成
    getGroupsGroupリストを照会
    getUserGroupを個別照会
    putGroupGroupを変更
    deleteGroupGroupを削除
    deleteGroupsGroupリストを削除
    postGroupToUserGroupを Userに追加
    getGroupUsersGroupに属する Userリストを照会
    getGroupAssignmentGroupが属する Assignmentリストを照会
    deleteGroupFromUserGroupを Userから削除
    deleteGroupFromAssignmentGroupを Assignmentから削除

    PermissionSet

    PermissionSetに関連した APIリストは次の通りです。

    API説明
    postPermissionSetPermissionSetを作成
    getPermissionSetsPermissionSetリストを照会
    getPermissionSetPermissionSetを個別照会
    putPermissionSetPermissionSetを変更
    deletePermissionSetPermissionSetを削除
    deletePermissionSetsPermissionSetリストを削除
    getPoliciesPermission Setに割り当て可能な Policyリストを照会
    existsPolicyPermissionSet内に Policyが存在するかどうか確認
    deletePolicyFromPermissionSetPermissionSet内の Policyを削除
    validatePermissionSetNamePermissionSet名のパターン、重複チェック

    Assignment

    Assignmentに関連した APIリストは次の通りです。

    API説明
    postAssignmentAssignmentを作成
    getAssignmentsAssignmentリストを照会
    getAssignmentAssignmentを個別照会
    putAssignmentAssignmentを変更
    changeAssignmentStatusAssignmentの状態を変更
    deleteAssignmentAssignmentを削除
    getAssignmentTargetsAssignment Targetリストを照会
    postAssignmentTargetsAssignment Targetを Assignmentに追加
    deleteAssignmentTargetsAssignment Targetを削除
    getAssignmentExistsPolicyAssignment内に対象の Policyが存在するかどうか確認
    getAssignmentByTargetTypeTargetTypeと一致する Assignmentリストを照会
    getAccountsAccountリストを照会
    addAssignmentIpAclsAssignmentに IP ACLを追加
    getAssignmentsIpAclsAssignmentに属する IP ACLリストを照会
    deleteAssignmentIpAclsAssignmentに属する IP ACLを削除

    IP ACL

    IP ACLに関連した APIリストは次の通りです。

    API説明
    validateIpAclNameIP ACL名の有効性検査
    postIPACLIP ACLを作成
    putIPACLIP ACLを変更
    deleteIPACLsIP ACLリストを削除
    deleteIPACLIP ACLを個別削除
    getIPACLsIP ACLリストを照会
    getIPACLIP ACLを個別照会
    addIpAclToAssignmentsIP ACLに Assignmentを追加
    getIpAclAssignmentsIP ACLが含まれた Assignmentを照会
    deleteIpAclAssignmentsIP ACLに割り当てられた Assignmentを削除

    共通の設定

    API URL

    API URLは次の通りです。

    https://sso.apigw.ntruss.com/api/v1
    

    メソッド

    使用可能なメソッドは次の通りです。

    GET, POST, PUT, DELETE
    

    ヘッダ

    リクエストヘッダ

    共通して使用するリクエストヘッダを紹介します。一部リクエストヘッダは Ncloud APIの共通ヘッダです。詳細は、Ncloud APIの共通ヘッダをご参照ください。リクエストヘッダの説明は次の通りです。

    ヘッダ説明種類
    x-ncp-apigw-timestamp- 1970年1月1日 00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの
    - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
    Ncloud APIの共通ヘッダ
    x-ncp-iam-access-keyNAVERクラウドプラットフォームで発行された API Keyまたは IAMで発行された AccessKeyNcloud APIの共通ヘッダ
    x-ncp-apigw-signature-v2- 上記例の Bodyを AccessKeyとマッピングする SecretKeyで暗号化した署名
    - HMACの暗号化アルゴリズムは HmacSHA256を使用
    Ncloud APIの共通ヘッダ

    共通モデル

    ProcessResult

    パラメータ名必須の有無タイプ説明
    successYBoolean処理結果
    idNString作成/変更結果 ID
    messageNString処理結果メッセージ
    • model
    ProcessResult {
      Boolean success;
      String id;
      String message;
    }
    
    • json
    {
      "id": "",
      "success": true
    }
    

    エラーコード

    Ncloud Single Sign-On APIで共通して使用するエラーコードを紹介します。サービス全体で共通して発生するエラーの詳細は、NAVERクラウドプラットフォーム APIをご参照ください。

    パラメータ名必須の有無タイプ説明
    errorCodeYintエラーコード
    messageYStringエラーメッセージ

    Ncloud Single Sign-On APIの共通エラーコード構文のサンプルコードは次の通りです。

    • model
    ErrorResponse {
      int errorCode;
      String message;
    }
    
    • json
    {
      "errorCode": 9011,
      "message": "エラーメッセージ"
    }
    

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.