개요

---

 
iwinv Object Storage는 온라인 저장소 서비스로 관리와 사용에 필요한 API(Swift, S3)를 제공합니다. 

Swift 2.24.1 : https://docs.openstack.org/api-ref/object-store/

Amazon S3 v2006-03-01: https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html

 

서비스 특징

---

https://help.iwinv.kr/manual/read.html?idx=709

 

 

호출도메인 (Endpoint)

---

HTTP/HTTPS 프로토콜을 모두 지원하며 데이터 보호를 위해 HTTPS 사용을 권장합니다.

현재는 대한민국 단일 리전만 지원합니다.

 

리전 (Region)	호출도메인(Endpoint)
대한민국 (Korea)	kr.object.iwinv.kr

 

 

 

인증키(Credential) 생성

---

iwinv내 Object Storage 서비스를 신청하게 되면 기본적으로 인증키가 한개 발급됩니다.

발급된 인증키는 iwinv 콘솔페이지 > 계정관리 > 인증키 관리에서 확인가능하며 최대 2개까지 발급가능합니다. 

 

 

 

토큰(Token) 생성

---

API를 사용하기 위해서는 우선 인증 토큰(Token)을 발급 받아야 합니다.

인증 토큰은 오브젝트 스토리지의 REST API를 사용할 때 필요한 인증 키입니다.

외부에 공개되지 않는 컨테이너 및 오브젝트에 접근하기 위해서는 반드시 토큰 인증이 필요합니다. 

발급된 토큰은 생성후 24시간이 지나면 만료됩니다. 

 

 

인증 토큰 발급

---

 

  

• 구문
  
  

  GET  /auth Host: kr.object.iwinv.kr X-Auth-User: {User-ID}:{Access-KEY-ID} X-Auth-Key: {Secret-Key}

  
  
  
• 요청 헤더
  

  ---

  
  X-Auth-User
  

  Description:     인증 사용자 ID

  Type:     String

  Required:     Yes
  
  
  X-Auth-Key

  Description:     인증 사용자 Secret Key

  Type:     String

  Required:     Yes
  
  
  

• 응답 헤더
  
  서버의 응답은 X-Auth-Token, X-Storage-Url 값이 포함되어야 합니다.
  

  ---

  
  X-Storage-Token
  

  Description:     요청에 응답한 인증 토큰

  Type:     String

  Required:     Yes
  
  
  X-Auth-User

  Description:     사용자의 URL 및 {api version}/{account} 경로

  Type:     String

  Required:     Yes

  

 

 

Account (계정)

---

 API에 사용되는 사용자 계정(account)는 AUTH_*****  형태의 문자열로 되어있으며 iwinv 콘솔페이지 > 계정관리를 통해 확인가능합니다.