Super Admin API

여러 tenant에 걸쳐 Thinkfree Drive 전체를 관리하는 API입니다. tenant 생성, tenant 주소에 사용할 베이스 도메인 설정, 로그인·공유 정책의 전체 tenant 일괄 적용을 다룹니다. 하나의 tenant를 관리하려면 Admin을 참고하세요. 슈퍼 관리자 경로를 포함한 전체 tenant의 API Key 발급과 관리는 Authentication에서 설명합니다.

Base URL과 권한

/api/external/v1/super-admin

이 endpoint를 호출하려면 SUPER_ADMIN 역할의 계정으로 발급된 API Key가 필요합니다. 일반 관리자의 키로는 호출할 수 없습니다.

scope를 검사하지 않음

관리자 endpoint와 마찬가지로 접근 권한은 역할로만 결정됩니다. api:read만 부여된 키로도 tenant 생성, 베이스 도메인 변경, 전체 tenant 정책 적용을 할 수 있습니다. 슈퍼 관리자 키는 발급할 때 지정한 scope와 관계없이 시스템에서 가장 높은 권한을 가진 키이므로 엄격하게 관리하세요.

tenant 접속용 키 발급 기능은 외부 API로 제공하지 않습니다.

실패하면 공통 실패 구조로 응답합니다. 각 endpoint가 반환하는 오류 코드는 아래 절에서 설명합니다.

Failure
{
  "result": false,
  "code": 404,
  "errorCode": "TENANT_001",
  "message": "..."
}

베이스 도메인

각 tenant의 주소는 모든 tenant가 함께 사용하는 베이스 도메인 아래의 서브도메인으로 정해집니다.

GET /api/external/v1/super-admin/base-domain
PUT /api/external/v1/super-admin/base-domain

베이스 도메인 조회

Read base domain
curl "https://drive.example.com/api/external/v1/super-admin/base-domain" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY"

필드	Type	의미
`baseDomainSeq`	integer	설정된 경우 항상 `1`, 설정 전이면 `null`
`baseDomain`	string	베이스 도메인. 설정 전이면 `null`

베이스 도메인을 설정하기 전에 조회해도 오류가 발생하지 않으며, 200과 함께 두 필드를 null로 반환합니다.

Configured
{
  "result": true,
  "code": 200,
  "message": "OK",
  "data": {
    "baseDomainSeq": 1,
    "baseDomain": "drive.example.com"
  }
}

Not configured
{
  "result": true,
  "code": 200,
  "message": "OK",
  "data": {
    "baseDomainSeq": null,
    "baseDomain": null
  }
}

베이스 도메인 설정

파라미터	Type	필수	설명
`bd`	string	Yes	전체 도메인 형식의 베이스 도메인, 최대 253자

bd에는 영문 소문자, 숫자, 하이픈만 사용할 수 있으며 대문자는 허용하지 않습니다. 점으로 구분된 각 라벨은 1-63자이고 영문 소문자나 숫자로 시작하고 끝나야 하며, 마지막 라벨(TLD)은 영문 2자 이상이어야 합니다. 규칙에 맞지 않으면 BASE_DOMAIN_002를 반환합니다.

Set base domain
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/base-domain" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"bd": "drive.example.com"}'

베이스 도메인이 없으면 새로 등록하고, 있으면 변경합니다. 성공하면 data 없이 200 OK를 반환합니다. 현재와 같은 값을 다시 보내도 성공하며, 아래의 tenant 도메인 변경도 다시 수행합니다.

베이스 도메인을 설정하면 tenant 도메인이 변경됨

베이스 도메인을 설정하면 tenant 도메인을 다음과 같이 다시 계산합니다.

처음 설정할 때 - 도메인이 있는 조직 tenant가 대상입니다. 기존 도메인의 첫 번째 라벨을 서브도메인으로 사용해 {subdomain}.{new base domain}으로 변경합니다. 점이 없는 도메인은 베이스 도메인과 같은 값으로 변경됩니다.
변경할 때 - 이 베이스 도메인에 연결된 tenant만 각 서브도메인을 기준으로 변경됩니다.

도메인이 없거나 베이스 도메인에 연결되지 않은 tenant는 변경되지 않습니다. 변경 중 하나라도 실패하면 전체 변경이 취소됩니다. 도메인이 바뀐 tenant는 이전 주소로 접속할 수 없으므로, 변경하기 전에 DNS, 인증서, 클라이언트에 직접 입력한 URL을 확인하세요.

코드	상태	의미
`REQUEST_001`	400	`bd`가 없거나 253자를 넘음
`BASE_DOMAIN_002`	400	`bd`가 유효한 도메인이 아님
`RESPONSE_001`	500	예상하지 못한 서버 오류

BASE_DOMAIN_001은 이 endpoint에서 반환되지 않습니다. tenant를 생성하거나 수정할 때 존재하지 않는 베이스 도메인을 bs로 지정하면 반환됩니다.

tenant

tenant 목록

GET /api/external/v1/super-admin/tenants

파라미터	Type	필수	설명
`ps`	integer	Yes	페이지 크기, 최소 `1`
`ci`	long	No	cursor - 이전 페이지의 마지막 `tenantSeq`

List tenants
curl "https://drive.example.com/api/external/v1/super-admin/tenants?ps=20" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY"

결과는 tenantSeq 내림차순으로 정렬됩니다. 조회한 항목 수가 페이지 크기와 같으면 응답에 hasNext: true와 마지막 항목의 tenantSeq인 nextCursor가 포함되며, 다음 페이지를 요청할 때 이 값을 ci로 보냅니다.

필드	Type	의미
`tenantSeq`	long	tenant 식별자
`tenantName`	string	tenant 이름
`domain`	string	`{subdomain}.{base domain}`. 없으면 `null`
`clientUrl`	string	`https://` 뒤에 `domain`을 붙인 값
`registerDate`	string	`YYYY-MM-DD HH:mm:ss.SSS`
`license`	object	라이선스 요약 또는 `null`

license는 라이선스가 없는 tenant뿐 아니라 라이선스 검증에 실패한 경우에도 null입니다. 그 외에는 state, expiresOn(YYYY-MM-DD), seat가 포함됩니다. seat는 사용자 수 제한 라이선스일 때만 current와 max를 포함하고 그 외에는 null이므로, 허용 사용자 수 초과 여부는 사용자 수 제한 라이선스에서만 확인할 수 있습니다.

List response
{
  "result": true,
  "code": 200,
  "message": "OK",
  "data": {
    "list": [
      {
        "tenantSeq": 12,
        "tenantName": "Example",
        "domain": "example.drive.example.com",
        "clientUrl": "https://example.drive.example.com",
        "registerDate": "2026-09-01 10:15:30.123",
        "license": null
      }
    ],
    "pageSize": 20,
    "hasNext": false
  }
}

tenant 조회

GET /api/external/v1/super-admin/tenants/{tenantSeq}

Read tenant
curl "https://drive.example.com/api/external/v1/super-admin/tenants/12" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY"

tenantSeq, tenantName, subdomain, baseDomainSeq, allowedIps를 반환합니다. allowedIps는 항상 {IP}/{prefix} 형식이며, 단일 IP는 /32로 표시됩니다. 존재하지 않는 tenant를 지정하면 TENANT_001을 반환합니다.

목록 조회는 서브도메인과 베이스 도메인을 결합한 domain을 반환하지만, 이 endpoint는 subdomain만 반환합니다.

Read response
{
  "result": true,
  "code": 200,
  "message": "OK",
  "data": {
    "tenantSeq": 12,
    "tenantName": "Example",
    "subdomain": "example",
    "baseDomainSeq": 1,
    "allowedIps": ["192.168.0.12/32", "192.168.0.0/24"]
  }
}

tenant 생성

POST /api/external/v1/super-admin/tenants

tenant와 첫 번째 관리자 계정, 허용 IP 목록을 한 번에 생성합니다.

파라미터	Type	필수	설명
`tn`	string	Yes	tenant 이름
`sd`	string	Yes	서브도메인, 최대 253자
`bs`	integer	Yes	베이스 도메인 seq
`e`	string	Yes	관리자 계정 id. 이메일 주소이며 모든 tenant에서 고유해야 함
`n`	string	Yes	관리자 표시 이름
`p`	string	Yes	관리자 비밀번호
`ips`	array	No	관리자 접속을 허용할 IPv4 주소 또는 CIDR 목록

sd에는 영문 소문자, 숫자, 하이픈만 사용할 수 있으며, 대문자를 포함하면 TENANT_007을 반환합니다. 점으로 구분된 각 라벨은 1-63자이고 영문 소문자나 숫자로 시작하고 끝나야 합니다. 전체 도메인은 {sd}.{base domain}입니다.
e가 다른 tenant를 포함해 이미 사용 중인 계정 id와 같으면 USER_004를 반환합니다.
p는 8-64자이며 영문 대문자, 소문자, 숫자, 특수문자를 각각 1자 이상 포함해야 합니다. 규칙에 맞지 않으면 USER_001을 반환합니다.
ips는 IPv4만 지원하며, 단일 IP는 /32로 저장됩니다. CIDR은 네트워크 주소여야 합니다. 예를 들어 192.168.0.0/24는 허용되지만 192.168.0.12/24는 ACCESS_004를 반환합니다.

Create tenant
curl -X POST "https://drive.example.com/api/external/v1/super-admin/tenants" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"tn": "Example", "sd": "example", "bs": 1, "e": "admin@example.com", "n": "Administrator", "p": "Test1234!", "ips": ["192.168.0.12", "192.168.0.0/24"]}'

성공하면 data 없이 201 Created를 반환합니다. 생성된 tenant의 tenantSeq는 tenant 목록에서 확인하세요.

관리자 계정은 ADMIN 역할과 저장 용량 0으로 생성되며, tenant의 로그인 유형은 local입니다. tenant, 관리자 계정, 허용 IP, 기본 설정 중 하나라도 생성에 실패하면 아무것도 생성되지 않습니다.

새 tenant는 기본 설정으로 생성됩니다. Office 도메인과 어댑터 이름은 빈 값이므로, tenant에서 문서를 열려면 별도로 설정해야 합니다. 공유 설정도 기본값으로 생성되며, tenant별 설정 사용, 외부 공유 끔, SPECIFIC_USERS 켬, ORG_LINK 켬, PUBLIC_LINK 끔으로 설정됩니다. 이 값은 해당 tenant의 Admin endpoint에서 변경할 수 있습니다.

tenant 수정

PATCH /api/external/v1/super-admin/tenants/{tenantSeq}

파라미터	Type	필수	설명
`tn`	string	Yes	tenant 이름
`sd`	string	Yes	서브도메인, 최대 253자
`bs`	integer	Yes	베이스 도메인 seq
`ips`	array	No	허용할 IPv4 주소 또는 CIDR 목록. 기존 목록 전체를 교체함

sd와 ips의 형식 규칙은 tenant 생성과 같습니다. 해당 tenant가 현재 사용하는 도메인은 중복으로 판단하지 않습니다. sd를 변경하면 tenant의 주소가 바뀝니다.

ips로 허용 IP 목록 전체를 교체함

보낸 목록이 기존 허용 IP 목록을 대체하며, 빈 배열을 보내면 모든 항목이 삭제됩니다. tn, sd, bs도 모두 필수이므로, 먼저 tenant를 조회한 뒤 변경하지 않을 값과 allowedIps를 함께 보내세요.

Update tenant
curl -X PATCH "https://drive.example.com/api/external/v1/super-admin/tenants/12" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"tn": "Example Inc.", "sd": "example", "bs": 1, "ips": ["192.168.0.12/32", "192.168.0.0/24"]}'

tenant 계정 검색

GET /api/external/v1/super-admin/tenants/{tenantSeq}/users/search

슈퍼 관리자 경로에서 API Key를 발급할 계정을 찾을 수 있도록 tenant의 계정을 검색합니다.

파라미터	Type	필수	설명
`sk`	string	Yes	계정 id 또는 이름에 대한 부분 일치 검색어
`rt`	string	No	`ADMIN` 또는 `USER`. 생략하면 두 역할 모두 조회. 그 외 역할은 `USER_028`

Search tenant accounts
curl "https://drive.example.com/api/external/v1/super-admin/tenants/12/users/search?sk=admin&rt=ADMIN" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY"

활성 계정만 이름 오름차순으로, 페이지 구분 없이 반환합니다. 각 항목에는 userSeq, userId, userName, status, roleType이 포함됩니다. 존재하지 않는 tenant를 지정하면 TENANT_001을 반환합니다.

tenant 오류

코드	상태	의미
`REQUEST_001`	400	필수 값 누락 또는 길이 초과
`TENANT_001`	404	tenant를 찾을 수 없음
`TENANT_006`	409	이미 사용 중인 도메인
`TENANT_007`	400	서브도메인 형식 오류
`BASE_DOMAIN_001`	404	`bs`에 해당하는 베이스 도메인이 없음
`USER_001`	400	관리자 비밀번호가 규칙에 맞지 않음
`USER_002`	400	관리자 계정 id가 이메일 형식이 아님
`USER_004`	409	이미 사용 중인 관리자 계정 id
`USER_013`	500	관리자 계정 저장 실패
`USER_028`	400	계정 검색의 `rt`가 `ADMIN`이나 `USER`가 아님
`ACCESS_004`	400	IP 주소 또는 CIDR 형식 오류
`RESPONSE_001`	500	예기치 않은 서버 오류

로그인 정책

tenant별 로그인 설정과 같은 항목을 사용하며, 슈퍼 관리자가 모든 tenant에 한 번에 적용할 수 있습니다.

GET /api/external/v1/super-admin/login-settings
PUT /api/external/v1/super-admin/login-settings

로그인 정책 조회

파라미터	Type	필수	설명
`s`	string	No	응답을 구성할 적용 범위 - `tenant` 또는 `global`
`l`	string	No	응답을 구성할 로그인 유형 - `local`, `oidc`, `jwt`

s와 l은 저장된 값을 필터링하는 조건이 아니라 응답을 구성하는 기준입니다. s, l, 저장된 적용 여부 순서로 우선 적용됩니다.

s=tenant면 tenant별 설정을 기준으로 응답합니다. loginType은 null, isEnforced는 false, configs는 빈 배열입니다.
s=global이거나 l을 지정하면 해당 로그인 유형의 provider 목록을 반환합니다. l을 지정하면 저장된 로그인 유형 대신 l의 값을 사용합니다.
둘 다 지정하지 않으면 저장된 적용 여부를 기준으로 응답합니다.

Read sign-in policy
curl "https://drive.example.com/api/external/v1/super-admin/login-settings?s=global&l=oidc" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY"

응답에는 superAdminLoginSettingSeq, loginType, isEnforced, configs가 포함됩니다. configs에는 전체 tenant 적용용으로 등록된 provider만 포함됩니다. OIDC의 scopes는 항상 null, allowIdpInitiated는 항상 false이며, registerDate는 OIDC provider에만 있습니다. 저장된 설정이 없으면 파라미터와 관계없이 모든 값이 null이고 configs는 빈 배열입니다.

Enforced JWT
{
  "result": true,
  "code": 200,
  "message": "OK",
  "data": {
    "superAdminLoginSettingSeq": 1,
    "loginType": "jwt",
    "isEnforced": true,
    "configs": [
      {
        "ssoProviderSeq": 3,
        "displayName": "Example SSO",
        "status": "ACTIVE",
        "config": {
          "type": "jwt",
          "issuer": "https://sso.example.com",
          "keySourceType": "public_key",
          "publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..."
        }
      }
    ]
  }
}

조회 응답에 secret이 평문으로 포함됨

tenant별 로그인 설정 조회와 마찬가지로 clientSecret과 publicKey를 마스킹 없이 반환합니다. 응답은 서버에서만 사용하세요.

로그인 정책 설정

파라미터	Type	필수	설명
`ie`	boolean	Yes	`true`면 이 설정을 모든 tenant에 적용, `false`면 tenant별 설정을 사용
`l`	string	조건부	로그인 유형 - `local`, `oidc`, `jwt`. `ie`가 `true`면 필수
`ps`	array	조건부	인증 provider 목록. `ie`가 `true`이고 `l`이 `oidc`나 `jwt`면 필수

provider와 config 객체의 필드는 Admin에서 설명하는 tenant별 로그인 설정과 같습니다. config.type이 l과 다르면 REQUEST_001을, saml처럼 정의되지 않은 l 값을 보내면 RESPONSE_001을 반환합니다. SSO_PROTOCOL_001과 SSO_PROTOCOL_002는 이 endpoint에서 반환되지 않습니다.

ie=false면 l과 ps는 무시되며, 저장된 전체 tenant 적용용 provider는 삭제되지 않고 유지됩니다.

OIDC - l=oidc로 저장하면 provider 목록 전체가 ps로 교체됩니다. 요청에 포함하지 않은 기존 provider는 삭제되므로, 유지하려면 ssoProviderSeq와 함께 다시 보내세요. status가 ACTIVE인 provider는 정확히 하나여야 하며, 그렇지 않으면 REQUEST_001을 반환합니다.
JWT - provider는 하나만 설정할 수 있습니다. 활성화된 JWT provider가 이미 있으면 해당 ssoProviderSeq를 지정해 수정해야 하며, 지정하지 않으면 SSO_PROVIDER_005를 반환합니다. status는 항상 ACTIVE로 저장됩니다. 다른 JWT provider가 이미 사용 중인 issuer를 지정하면 SSO_PROTOCOL_JWT_002를 반환합니다.
displayName은 앞뒤 공백을 제거한 값이 요청 안에서 중복되면 안 되며, 중복되면 REQUEST_001을 반환합니다. 존재하지 않거나 전체 tenant 적용용 provider가 아닌 ssoProviderSeq를 지정하면 SSO_PROVIDER_001을 반환합니다.
publicKey는 PEM 헤더·푸터와 공백을 제거한 값으로 저장되며, 조회할 때도 같은 형태로 반환됩니다.

성공하면 data 없이 200 OK를 반환합니다. ie가 true인 동안 tenant 관리자가 tenant의 로그인 설정을 변경하면 SSO_PROVIDER_006을 반환합니다.

Enforce local sign-in
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/login-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"ie": true, "l": "local"}'

Enforce OIDC
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/login-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"ie": true, "l": "oidc", "ps": [{"displayName": "Example SSO", "status": "ACTIVE", "config": {"type": "oidc", "issuerUrl": "https://sso.example.com", "clientId": "example-client", "clientSecret": "replace-with-your-client-secret"}}]}'

Enforce JWT
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/login-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"ie": true, "l": "jwt", "ps": [{"ssoProviderSeq": 3, "displayName": "Example SSO", "config": {"type": "jwt", "issuer": "https://sso.example.com", "keySourceType": "public_key", "publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..."}}]}'

tenant별 설정과 필드 이름이 다름

이 endpoint는 tenant별 설정의 loginType, providers 대신 l, ps를 사용하며 ie가 추가됩니다. 조회 응답도 superAdminEnforced가 아니라 isEnforced를 반환합니다. config 객체는 같습니다.

로그인 정책 오류

코드	상태	의미
`REQUEST_001`	400	필수 값 누락 또는 규칙 위반. 조회의 `s`·`l` 값 오류 포함
`SSO_PROVIDER_001`	404	`ssoProviderSeq`가 없거나 전체 tenant 적용용 provider가 아님
`SSO_PROVIDER_005`	409	활성화된 JWT provider가 있는데 `ssoProviderSeq`를 보내지 않음
`SSO_PROTOCOL_JWT_002`	409	다른 provider가 이미 사용 중인 JWT `issuer`
`RESPONSE_001`	500	예기치 않은 서버 오류. 설정할 때 정의되지 않은 `l`을 보낸 경우 포함

공유 정책

GET /api/external/v1/super-admin/share-settings
PUT /api/external/v1/super-admin/share-settings

공유 정책 조회

Read sharing policy
curl "https://drive.example.com/api/external/v1/super-admin/share-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY"

필드	Type	의미
`shareSettingSeq`	long	설정 식별자
`isEnforced`	boolean	모든 tenant에 정책을 적용하는지 여부
`shareEnabled`	boolean	공유 기능 사용 여부
`externalShareAllowed`	boolean	조직 외부 공유 허용 여부
`allowSpecificUsers`	boolean	`SPECIFIC_USERS` 공유 유형 허용 여부
`allowOrgLink`	boolean	`ORG_LINK` 공유 유형 허용 여부
`allowPublic`	boolean	`PUBLIC_LINK` 공유 유형 허용 여부

isEnforced가 false여도 저장된 값, 즉 마지막으로 모든 tenant에 적용했던 값을 반환합니다. 저장된 설정이 없으면 모든 필드가 null입니다.

Enforced
{
  "result": true,
  "code": 200,
  "message": "OK",
  "data": {
    "shareSettingSeq": 1,
    "isEnforced": true,
    "shareEnabled": true,
    "externalShareAllowed": false,
    "allowSpecificUsers": true,
    "allowOrgLink": true,
    "allowPublic": false
  }
}

공유 정책 설정

파라미터	Type	필수	설명
`e`	boolean	Yes	`true`면 이 설정을 모든 tenant에 적용, `false`면 tenant별 설정을 사용
`se`	boolean	조건부	공유 기능 사용 여부. `e`가 `true`면 필수
`esa`	boolean	조건부	조직 외부 공유 허용 여부. `e`와 `se`가 `true`면 필수
`sua`	boolean	조건부	`SPECIFIC_USERS` 공유 유형 허용 여부. `e`와 `se`가 `true`면 필수
`ola`	boolean	조건부	`ORG_LINK` 공유 유형 허용 여부. `e`와 `se`가 `true`면 필수
`pa`	boolean	조건부	`PUBLIC_LINK` 공유 유형 허용 여부. `e`와 `se`가 `true`면 필수

공유 기능을 켠 상태로 모든 tenant에 적용할 때는 sua, ola, pa 중 하나 이상이 true여야 하며, pa를 켜려면 esa도 true여야 합니다. tenant별 공유 설정과 같은 규칙입니다.

적용되지 않는 값은 무시되며 저장된 값이 유지됩니다. e=false면 se, esa, sua, ola, pa가 무시되고 기존 공유도 삭제되지 않습니다. e=true이고 se=false면 esa, sua, ola, pa가 무시됩니다.

성공하면 data 없이 200 OK를 반환합니다. e가 true인 동안 각 tenant의 공유 설정 조회 endpoint는 isEnforced를 true로 반환하며, tenant의 설정 대신 이 전역 설정을 반환합니다.

모든 tenant에 적용하면 기존 공유가 삭제될 수 있으며, 설정을 되돌려도 복구되지 않음

e=true로 저장하면 각 조직 tenant의 변경 전 설정과 비교해, 허용에서 허용하지 않음으로 바뀐 항목의 기존 공유를 삭제합니다.

공유 기능 끔 - tenant의 모든 공유
SPECIFIC_USERS, ORG_LINK, PUBLIC_LINK를 허용하지 않음 - 해당 공유 유형의 공유와 공유 대상, 관련된 최근 문서함· 중요 문서함·고정 폴더 항목
외부 공유를 허용하지 않음 - 다른 tenant에 속한 공유 대상과 해당 사용자의 최근 문서함·중요 문서함·고정 폴더 항목

이후 e를 다시 false로 변경하면 각 tenant의 설정은 원래대로 돌아가지만, 삭제된 공유는 복구되지 않습니다.

Leave each tenant to its own
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/share-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"e": false}'

Enforce with sharing off
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/share-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"e": true, "se": false}'

Enforce with sharing on
curl -X PUT "https://drive.example.com/api/external/v1/super-admin/share-settings" \
  -H "Authorization: Bearer replace-with-your-SUPERADMIN-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"e": true, "se": true, "esa": false, "sua": true, "ola": true, "pa": false}'

공유 정책 오류

코드	상태	의미
`REQUEST_001`	400	`e` 누락, 모든 tenant에 적용할 때 `se` 누락, 모든 tenant에 적용하면서 공유 기능을 켤 때 `esa`·`sua`·`ola`·`pa` 누락, `sua`·`ola`·`pa`가 모두 `false`, 또는 `esa`가 `false`인데 `pa`가 `true`
`RESPONSE_001`	500	예기치 않은 서버 오류

오류

API 전체의 오류 코드는 Errors를 참고하세요.

Base URL과 권한​

베이스 도메인​

베이스 도메인 조회​

베이스 도메인 설정​

tenant​

tenant 목록​

tenant 조회​

tenant 생성​

tenant 수정​

tenant 계정 검색​

tenant 오류​

로그인 정책​

로그인 정책 조회​

로그인 정책 설정​

로그인 정책 오류​

공유 정책​

공유 정책 조회​

공유 정책 설정​

공유 정책 오류​

오류​