API Authentication (TMS)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

대부분의 API 호출에는 인증된 사용자 필요합니다. API는 특수 사용자 프로필을 사용 않습니다. 각 API 사용자의 사용자 이름과 암호를 사용하여 기존 사용자 대신 호출할 수 있습니다.

API 인증할 수 있는 두 가지 방법이 있습니다.

토큰 기반 인증
OAuth 2.0 인증

토큰 기반 인증

인증된 사용자가 필요한 API를 호출하기 전에 auth/login API를 호출하여 인증 토큰을 얻으십시오. 토큰 24시간 동안 유효하며 후속 호출에 모두 사용할 수 있지만 사용자 UI를 통해 로그아웃하면 만료됩니다. 모든 호출마다 새 토큰 생성 마십시오.

여러 TMS 조직의 구성원은 여러 계정에 대해 동일한 사용자 이름과 암호가 있습니다. 여러 계정이 사용되는 경우 사용자가 로그인하려는 조직을 지정하려면 요청 본문에 userUid를 추가해야 합니다. 지정되지 않은 경우 사용자 지정된 사용자 이름과 암호와 연결된 기본 계정 로그인됩니다.

후속 API 호출에서는 얻은 토큰이 인증 헤더에서 사용됩니다. 헤더 값 필드는 ApiToken 뒤에 공백과 토큰 자체와 함께 입력됩니다.

사용자 UI에서 로그아웃하면 API 토큰 더 이상 유효하지 않습니다.

프로필이 미국 DataCenter에 있는 경우 cloud.memsource.com 이전에 우리를 추가하십시오(예: https://us.cloud.memsource.com/web/api2/v3/auth/login.

예:

ApiToken OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi

OAuth 2.0 인증

각 호출 시 토큰을 보낼 대신 애플리케이션에서 OAuth 2.0를 사용하십시오. Phrase TMS는 표준 OAuth 2.0 인증 코드 부여 유형을 지원합니다.

다음의 단계에 따라 OAuth 2.0 연결을 설정하십시오.

설정 페이지에서 통합 섹션으로 스크롤하여 Registered OAuth Apps을 클릭합니다.

Registered OAuth Apps 페이지가 열립니다.
신규를 클릭합니다.

생성 OAuth 앱 페이지가 열립니다.
이름, 리디렉션 URI(콜백) 및 선택적인 설명을 제공합니다.
저장을 클릭합니다.

Registered OAuth Apps 페이지는 목록에 새 연결과 연결된 클라이언트 ID로 열립니다.

ID phrase 연결하여 연결을 설정하는 응용 프로그램에서 사용됩니다. 데이터베이스에 저장되어 요청을 적절한 요청자와 연결하는 데 사용됩니다.
인증에 생성된 클라이언트 ID 함께 이 URL을 사용.
- Auth URL
  
  https://cloud.memsource.com/web/oauth/authorize
- 토큰 URL
  
  https://cloud.memsource.com/web/oauth/token
프로필이 미국 DataCenter에 있는 경우 cloud.memsource.com 이전에 우리를 추가하십시오(예: https://us.cloud.memsource.com/web/oauth/authorize).
인증 시 관리자 프로필 사용하여 로그인 후 허용을 클릭합니다.

이제 애플리케이션이 연결되었으며 인증 API 호출이 필요하지 않습니다.

OAuth 2.0 연결이 설정되면 애플리케이션에서 사용 위해 Bearer 토큰 생성됩니다.

Bearer 토큰 사용 예시:

Bearer OKTiI2V7QqRDu0HADR2Fk2b9hCteI1pT06bOSk5OD8HSc3oCOHMzIgVtOtLV65hi