이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Google 데이터 프로토콜 클라이언트 라이브러리의 OAuth

경고: 이 페이지는 Google의 이전 API인 Google Data API에 관한 것으로, Google Data API 디렉터리에 표시된 API 중 상당수가 최신 API로 대체된 API입니다. 특정 새 API에 대한 자세한 내용은 새 API 문서를 참조하세요. 최신 API를 사용하여 요청을 승인하는 방법은 Google 계정 인증 및 승인을 참고하세요.

이 문서에서는 Google Data API 클라이언트 라이브러리를 사용하여 Google의 웹 애플리케이션용 OAuth 인증에 연결하는 방법을 설명합니다.

OAuth 인터페이스를 사용하면 웹 기반 애플리케이션에서 사용자를 대신하여 Google 서비스에 액세스할 수 있습니다. 높은 수준의 보안을 유지하기 위해 OAuth를 사용하면 애플리케이션이 사용자의 계정 로그인 정보를 처리하지 않고도 액세스 토큰을 얻을 수 있습니다.

Google Data API 클라이언트 라이브러리는 웹 애플리케이션에서 OAuth를 사용하는 데 도움이 되는 메서드를 제공합니다. 특히 요청 토큰을 획득하고, 요청 토큰을 승인하고, 액세스 토큰에 대해 승인된 요청 토큰을 교환하는 메서드가 있습니다. 또한 라이브러리는 Google 데이터 서비스에 요청할 때 필요한 서명 알고리즘을 처리합니다.

대상

이 문서는 웹 기반 애플리케이션이 Google Data API 클라이언트 라이브러리를 사용하여 사용자를 대신하여 Google 서비스에 액세스하도록 하려는 프로그래머를 대상으로 합니다.

이 문서에서는 OAuth 인터페이스와 OAuth를 웹 애플리케이션에 통합하는 일반적인 프로세스에 익숙하다고 가정합니다. OAuth 프로토콜에 대한 자세한 내용은 웹 애플리케이션용 OAuth 인증 또는 auth.net의 공식 사양을 참조하세요.

클라이언트 라이브러리 없이 3-Legged OAuth 및 Google 데이터 API 사용

웹 애플리케이션이 OAuth를 승인 방법으로 사용하여 Google 데이터 서비스와 상호작용하게 하려면 웹 애플리케이션용 OAuth 인증을 알아야 합니다. Google 데이터 API 클라이언트 라이브러리를 사용하지 않아도 됩니다.

애플리케이션에서 OAuth를 사용하여 사용자를 인증하는 방법은 다음과 같습니다.

애플리케이션은 서명된 엔드포인트에서 OAuthRequestToken 엔드포인트에서 초기 OAuth 요청 토큰을 가져옵니다.
애플리케이션은 사용자를 적절한 OAuthAuthorizeToken URL로 리디렉션하여 요청 토큰을 승인합니다.
액세스 권한을 부여하면 사용자가 다시 애플리케이션 (oauth_callback URL)으로 리디렉션됩니다.
애플리케이션은 OAuthGetAccessToken 엔드포인트를 사용하여 승인된 요청 토큰을 액세스 토큰으로 업그레이드하기 위해 서명된 요청을 보냅니다.

Google Data API 클라이언트 라이브러리는 다양한 세부정보를 처리하여 이 승인 프로세스를 간소화합니다. 이 문서에서는 그 방법을 설명합니다.

웹 애플리케이션 등록

OAuth를 사용하려면 모든 API 호출에 디지털 서명이 필요합니다. Google은 HMAC-SHA1 및 RSA-SHA1 서명 메서드를 지원합니다. 요청에 서명하려면 먼저 애플리케이션이 Google에 등록되어야 합니다. 등록하고 나면 Google에서 일반 키 (HMAC-SHA1와 함께 사용할 수 있는 보안 비밀)와 공개 인증서를 업로드할 위치를 제공합니다.

1. 도메인 등록

웹 기반 애플리케이션 등록에 설명된 단계를 따르세요.

2. 비공개 키 / 공개 인증서 쌍 만들기 (선택사항)

RSA-SHA1를 oauth_signature_method로 사용하려면 자체 서명 RSA 비공개 키 및 공개 인증서 쌍을 만들어야 합니다. 이를 수행하는 방법에 대한 예시는 자체 서명 비공개 키 및 공개 인증서 생성(아래)을 참조하세요.

3-Legged OAuth 및 Google 데이터 API 작업: 클라이언트 라이브러리 예

다음 섹션에서는 Google Data API 클라이언트 라이브러리 메서드를 사용하여 OAuth 문서의 'OAuth 작업' 섹션에 설명된 단계를 따르는 예를 보여줍니다. 이 문서의 모든 예시에서는 애플리케이션 호스트 도메인이 example.com이라고 가정합니다.

데이터 액세스 범위 확인

각 Google 서비스는 토큰에 대한 사용자 데이터 액세스를 결정하는 scope 값을 정의합니다. 사용 가능한 범위 값은 Google 데이터 FAQ에 나와 있습니다. 예를 들어 Documents List API를 사용하려면 FAQ에 나와 있는 대로 scope를 https://docs.google.com/feeds/로 설정합니다.

참고: scope 값을 필요한 액세스를 허용하는 가장 좁은 URL로 설정합니다. 이렇게 하면 실수로 개인 정보를 가져와 누출할 가능성이 줄어듭니다. 예를 들어 현재 사용자의 비공개 문서 목록 피드에 액세스하려면 모든 문서 목록 피드에 대한 액세스를 제공하는 https://docs.google.com/feeds/과 같이 더 광범위한 범위 대신 https://docs.google.com/feeds/default/private/full 범위를 사용합니다.

다중 범위 토큰

여러 Google Data API에 액세스하는 토큰을 만들려면 각 범위를 공백 문자로 구분합니다. 아래 예에서는 사용자의 Google Docs 및 Google Calendar 데이터에 모두 액세스할 수 있는 토큰을 만듭니다.

scope=https://www.google.com/calendar/feeds/ https://docs.google.com/feeds/

URL 인코딩

HTTP를 통해 전송하려면 콜론, 슬래시, 공백 등 URL에 표시되는 비ASCII 문자가 URL 인코딩되어야 합니다. Google Data API 클라이언트 라이브러리는 자동으로 매개변수를 URL 인코딩하므로 매개변수에 값을 할당할 때 URL이 인코딩되지 않은 문자열을 사용할 수 있습니다. 예를 들어 코드에서 다음과 같이 할당할 수 있습니다.

scope=https://www.google.com/calendar/feeds/ https://docs.google.com/feeds/

클라이언트 라이브러리를 호출하면 scope 매개변수가 자동으로 다음 값으로 URL 인코딩됩니다.

https%3a%2f%2fwww.google.com%2fcalendar%2ffeeds%2f+https%3a%2f%2fdocs.google.com%2ffeeds%2f

요청 토큰 가져오기

자바

HMAC-SHA1의 경우 승인 페이지에서 오는 OAuth 토큰 객체를 만들려면 응답에서 얻은 토큰 보안 비밀을 유지하는 방법이 필요합니다. 이렇게 하려면 세션 변수 또는 쿠키를 설정하세요.

import com.google.gdata.client.docs.*;
import com.google.gdata.client.authn.oauth.*;

String CONSUMER_KEY = "example.com";
String CONSUMER_SECRET = "abc123doremi";

GoogleOAuthParameters oauthParameters = new GoogleOAuthParameters();
oauthParameters.setOAuthConsumerKey(CONSUMER_KEY);
oauthParameters.setOAuthConsumerSecret(CONSUMER_SECRET);
oauthParameters.setScope("https://docs.google.com/feeds/");
oauthParameters.setOAuthCallback("http://www.example.com/UpgradeToken.jsp");

GoogleOAuthHelper oauthHelper = new GoogleOAuthHelper(new OAuthHmacSha1Signer());
oauthHelper.getUnauthorizedRequestToken(oauthParameters);

RSA-SHA1를 사용하면 oauth_token_secret가 사용되지 않으므로 토큰 보안 비밀을 유지할 필요가 없습니다.

import com.google.gdata.client.docs.*;
import com.google.gdata.client.authn.oauth.*;

String CONSUMER_KEY = "example.com";

GoogleOAuthParameters oauthParameters = new GoogleOAuthParameters();
oauthParameters.setOAuthConsumerKey(CONSUMER_KEY);
oauthParameters.setScope("https://docs.google.com/feeds/");
oauthParameters.setOAuthCallback("http://www.example.com/UpgradeToken.jsp");

PrivateKey privKey = getPrivateKey("/path/to/your/rsakey.pk8");

GoogleOAuthHelper oauthHelper = new GoogleOAuthHelper(new OAuthRsaSha1Signer(privKey));
oauthHelper.getUnauthorizedRequestToken(oauthParameters);

...

public static PrivateKey getPrivateKey(String privKeyFileName) {
  File privKeyFile = new File(privKeyFileName);
  FileInputStream fis = new FileInputStream(privKeyFile);
  DataInputStream dis  = new DataInputStream(fis);

  byte[] privKeyBytes = new byte[(int) privKeyFile.length()];
  dis.read(privKeyBytes);
  dis.close();
  fis.close();

  String BEGIN = "-----BEGIN PRIVATE KEY-----";
  String END = "-----END PRIVATE KEY-----";
  String str = new String(privKeyBytes);
  if (str.contains(BEGIN) && str.contains(END)) {
    str = str.substring(BEGIN.length(), str.lastIndexOf(END));
  }

  KeyFactory fac = KeyFactory.getInstance("RSA");
  EncodedKeySpec privKeySpec = new PKCS8EncodedKeySpec(Base64.decode(str));
  return fac.generatePrivate(privKeySpec);
}

PHP

서명 메서드로 HMAC-SHA1 사용:

require_once 'Zend/Oauth/Consumer.php';

session_start();

$CONSUMER_KEY = 'example.com';
$CONSUMER_SECRET = 'abc123doremi';

// Multi-scoped token.
$SCOPES = array(
  'https://docs.google.com/feeds/',
  'https://spreadsheets.google.com/feeds/'
);

$oauthOptions = array(
  'requestScheme' => Zend_Oauth::REQUEST_SCHEME_HEADER,
  'version' => '1.0',
  'consumerKey' => $CONSUMER_KEY,
  'consumerSecret' => $CONSUMER_SECRET,
  'signatureMethod' => 'HMAC-SHA1',
  'callbackUrl' => 'http://myapp.example.com/access_token.php',
  'requestTokenUrl' => 'https://www.google.com/accounts/OAuthGetRequestToken',
  'userAuthorizationUrl' => 'https://www.google.com/accounts/OAuthAuthorizeToken',
  'accessTokenUrl' => 'https://www.google.com/accounts/OAuthGetAccessToken'
);

$consumer = new Zend_Oauth_Consumer($oauthOptions);

// When using HMAC-SHA1, you need to persist the request token in some way.
// This is because you'll need the request token's token secret when upgrading
// to an access token later on. The example below saves the token object as a session variable.
if (!isset($_SESSION['ACCESS_TOKEN'])) {
  $_SESSION['REQUEST_TOKEN'] = serialize($consumer->getRequestToken(array('scope' => implode(' ', $SCOPES))));
}

서명 메서드로 RSA-SHA1 사용:

require_once 'Zend/Crypt/Rsa/Key/Private.php';
require_once 'Zend/Oauth/Consumer.php';

session_start();

$CONSUMER_KEY = 'example.com';
$SCOPE = 'https://docs.google.com/feeds/';

$oauthOptions = array(
  'requestScheme' => Zend_Oauth::REQUEST_SCHEME_HEADER,
  'version' => '1.0',
  'consumerKey' => $CONSUMER_KEY,
  'consumerSecret' => new Zend_Crypt_Rsa_Key_Private(file_get_contents(realpath('/path/to/yourRSAPrivateKey.pem'))),
  'signatureMethod' => 'RSA-SHA1',
  'callbackUrl' => 'http://myapp.example.com/access_token.php',
  'requestTokenUrl' => 'https://www.google.com/accounts/OAuthGetRequestToken',
  'userAuthorizationUrl' => 'https://www.google.com/accounts/OAuthAuthorizeToken',
  'accessTokenUrl' => 'https://www.google.com/accounts/OAuthGetAccessToken'
);

$consumer = new Zend_Oauth_Consumer($oauthOptions);

if (!isset($_SESSION['ACCESS_TOKEN'])) {
  $_SESSION['REQUEST_TOKEN'] = serialize($consumer->getRequestToken(array('scope' => $SCOPE)));
}

Python

서명 메서드로 HMAC-SHA1 사용:

GDClient 기반의 최신 v2.0 이상 클래스를 사용하는 경우 다음을 사용합니다.

import gdata.gauth
import gdata.docs.client

CONSUMER_KEY = 'example.com'
CONSUMER_SECRET = 'abc123doremi'
SCOPES = ['https://docs.google.com/feeds/', 'https://www.google.com/calendar/feeds/']  # example of a multi-scoped token

client = gdata.docs.client.DocsClient(source='yourCompany-YourAppName-v1')

oauth_callback_url = 'http://%s/get_access_token' % self.request.host
request_token = client.GetOAuthToken(
    SCOPES, oauth_callback_url, CONSUMER_KEY, consumer_secret=CONSUMER_SECRET)

# When using HMAC-SHA1, you need to persist the request_token in some way.
# You'll need the token secret when upgrading to an access token later on.
# In Google App Engine, you can use the AeSave helper:
# gdata.gauth.AeSave(request_token, 'myKey')

서명 메서드로 RSA-SHA1 사용:

...

f = open('/path/to/yourRSAPrivateKey.pem')
RSA_KEY = f.read()
f.close()

request_token = client.GetOAuthToken(SCOPES, oauth_callback_url, CONSUMER_KEY, rsa_private_key=RSA_KEY)

또는 GDataService에 기반한 이전 v1.0 클래스를 사용하는 경우 호출은 약간 다릅니다.

import gdata.auth
import gdata.docs.service

CONSUMER_KEY = 'example.com'
CONSUMER_SECRET = 'abc123doremi'

client = gdata.docs.service.DocsService(source='yourCompany-YourAppName-v1')
client.SetOAuthInputParameters(gdata.auth.OAuthSignatureMethod.HMAC_SHA1, CONSUMER_KEY, consumer_secret=CONSUMER_SECRET)

req_token = client.FetchOAuthRequestToken()
client.SetOAuthToken(req_token)

서명 메서드로 RSA-SHA1 사용:

...

f = open('/path/to/yourRSAPrivateKey.pem')
RSA_KEY = f.read()
f.close()

client = gdata.docs.service.DocsService(source='yourCompany-YourAppName-v1')
client.SetOAuthInputParameters(gdata.auth.OAuthSignatureMethod.RSA_SHA1, CONSUMER_KEY, rsa_key=RSA_KEY)

SCOPES = ['https://docs.google.com/feeds/', 'https://www.google.com/calendar/feeds/']  # example of a multi-scoped token
req_token = client.FetchOAuthRequestToken(scopes=SCOPES)
client.SetOAuthToken(req_token)

.NET

서명 메서드로 HMAC-SHA1 사용:

using Google.GData.Client;

string CONSUMER_KEY = "example.com";
string CONSUMER_SECRET = "abc123doremi";

// Multi-scoped token.
string SCOPE = "https://www.google.com/calendar/feeds/ https://www.google.com/m8/feeds/";

OAuthParameters parameters = new OAuthParameters() {
  ConsumerKey = CONSUMER_KEY,
  ConsumerSecret = CONSUMER_SECRET,
  Scope = SCOPE,
  Callback = "http://myapp.example.com/access_token",
  SignatureMethod = "HMAC-SHA1"
}

OAuthUtil.GetUnauthorizedRequestToken(parameters);

서명 메서드로 RSA-SHA1 사용:

RSA-SHA1 is not supported yet.

요청 토큰 승인

요청 토큰을 승인하려면 애플리케이션에서 사용자를 OAuthAuthorizeToken URL로 리디렉션하여 Google 계정에 로그인하라는 메시지를 표시해야 합니다. OAuthAuthorizeToken URL에 대한 자세한 내용은 전체 웹 애플리케이션용 OAuth 인증을 참고하세요.

애플리케이션에서 OAuthAuthorizeToken URL을 구성하려면 각 클라이언트 라이브러리에 다음을 사용합니다. 참고로, 이 샘플은 이전 예를 바탕으로 빌드되었습니다.

승인 페이지 URL을 구성한 후 애플리케이션은 다양한 방법으로 이 URL을 사용하여 사용자를 OAuthAuthorizeToken 핸들러로 보낼 수 있습니다. 가장 일반적인 방법은 사용자를 리디렉션하거나 페이지 링크를 표시하는 것입니다.

콜백 URL에서 토큰 추출

Google에서 애플리케이션으로 다시 리디렉션되면 oauth_token이(가) 쿼리 매개변수로 'oauth_callback_url' URL에 추가됩니다. 그런 다음 애플리케이션은 URL 쿼리 매개변수에서 토큰 값을 추출하고 OAuth 매개변수를 다시 설정해야 합니다.

클라이언트 라이브러리는 oauth_token 추출을 위한 편의 메서드를 제공합니다. 이 샘플은 이전 예를 기반으로 합니다.

액세스 토큰으로 업그레이드

OAuth 토큰 댄스의 마지막 단계는 전체 웹 애플리케이션용 OAuth 인증 문서에 설명된 대로 OAuthGetAccessToken URL을 사용하여 승인된 요청 토큰을 장기 액세스 토큰으로 업그레이드하는 것입니다.

다음은 각 클라이언트 라이브러리를 사용하는 몇 가지 예입니다.

참고: HMAC-SHA1를 사용하는 경우 액세스 토큰의 토큰 비밀번호를 데이터베이스의 토큰 값과 함께 저장해야 합니다. 그렇지 않으면 나중에 사용할 수 있도록 OAuth 매개변수를 올바르게 재구성할 수 없습니다.

액세스 토큰 사용

액세스 토큰을 가져온 후 표준 Google Data API 클라이언트 라이브러리 호출을 사용하여 서비스와 상호작용합니다. 라이브러리는 요청에 서명하고 올바른 승인 헤더를 포함하여 처리합니다. 일반적으로 쿠키 또는 데이터베이스에서 사용자의 토큰을 리콜합니다. 이 예는 OAuth 매개변수를 재구성하고 클라이언트 라이브러리를 호출하는 방법을 보여줍니다.

자바

HMAC-SHA1를 사용하는 경우

  GoogleOAuthParameters oauthParameters = new GoogleOAuthParameters();
  oauthParameters.setOAuthConsumerKey(CONSUMER_KEY);
  oauthParameters.setOAuthConsumerSecret(CONSUMER_SECRET);
  oauthParameters.setOAuthToken(ACCESS_TOKEN);
  oauthParameters.setOAuthTokenSecret(TOKEN_SECRET);

  DocsService client = new DocsService("yourCompany-YourAppName-v1");
  client.setOAuthCredentials(oauthParameters, new OAuthHmacSha1Signer());

  URL feedUrl = new URL("https://docs.google.com/feeds/default/private/full");
  DocumentListFeed resultFeed = client.getFeed(feedUrl, DocumentListFeed.class);
  for (DocumentListEntry entry : resultFeed.getEntries()) {
    System.out.println(entry.getTitle().getPlainText());
  }

RSA-SHA1와의 차이점은 액세스 토큰의 보안 비밀을 설정할 필요가 없고 서명자 객체를 구성하는 방식이 다르다는 점입니다.

  GoogleOAuthParameters oauthParameters = new GoogleOAuthParameters();
  oauthParameters.setOAuthConsumerKey(CONSUMER_KEY);
  oauthParameters.setOAuthConsumerSecret(CONSUMER_SECRET);
  oauthParameters.setOAuthToken(ACCESS_TOKEN);

  PrivateKey privKey = getPrivateKey("/path/to/your/rsakey.pk8");  // See above for the defintion of getPrivateKey()

  DocsService client = new DocsService("yourCompany-YourAppName-v1");
  client.setOAuthCredentials(oauthParameters, new OAuthRsaSha1Signer(privKey));

  URL feedUrl = new URL("https://docs.google.com/feeds/default/private/full");
  DocumentListFeed resultFeed = client.getFeed(feedUrl, DocumentListFeed.class);
  for (DocumentListEntry entry : resultFeed.getEntries()) {
    System.out.println(entry.getTitle().getPlainText());
  }

PHP

require_once 'Zend/Gdata/Docs.php';

if (isset($_SESSION['ACCESS_TOKEN'])) {
  $accessToken = unserialize($_SESSION['ACCESS_TOKEN']);
} else {
  exit;
}


/*  Or, you could set an existing token (say one stored from your database). For HMAC-SHA1:
$accessToken = new Zend_Oauth_Token_Access();
$accessToken->setToken('1/AQfoI-qJDqkvvkf216Gc2g');
$accessToken->setTokenSecret('2c26GLW250tZiQ');
*/

$httpClient = $accessToken->getHttpClient($oauthOptions);
$client = new Zend_Gdata_Docs($httpClient, "yourCompany-YourAppName-v1");

// Retrieve user's list of Google Docs
$feed = $client->getDocumentListFeed();
foreach ($feed->entries as $entry) {
  echo "$entry->title\n";
}

Python

이 스니펫에서는 개발자가 이미 HMAC-SHA1를 사용하여 액세스 토큰을 가져왔고, 나중에 사용하기 위해 이 토큰 키/비밀번호를 기억하고 있다고 가정합니다.

GDClient 기반의 최신 v2.0 이상 클래스를 사용하는 경우 다음을 사용합니다.

client = gdata.docs.client.DocsClient(source='yourCo-yourAppName-v1')
client.auth_token = gdata.gauth.OAuthHmacToken(CONSUMER_KEY, CONSUMER_SECRET, TOKEN,
                                               TOKEN_SECRET, gdata.gauth.ACCESS_TOKEN)
feed = client.GetDocList()
for entry in feed.entry:
  print entry.title.text

GDataService에 기반한 이전 v1.0 클래스를 사용하는 경우 다음을 사용합니다.

client = gdata.docs.service.DocsService(source='yourCompany-YourAppName-v1')
client.SetOAuthInputParameters(SIG_METHOD, CONSUMER_KEY, consumer_secret=CONSUMER_SECRET)

# the token key and secret should be recalled from your database
client.SetOAuthToken(gdata.auth.OAuthToken(key=TOKEN, secret=TOKEN_SECRET))

feed = client.GetDocumentListFeed()
for entry in feed.entry:
  print entry.title.text

.NET

HMAC-SHA1를 사용하는 경우

OAuthParameters parameters = new OAuthParameters() {
  ConsumerKey = CONSUMER_KEY,
  ConsumerSecret = CONSUMER_SECRET,
  Token = ACCESS_TOKEN,
  TokenSecret = TOKEN_SECRET
}

GOAuthRequestFactory requestFactory = new GOAuthRequestFactory("writely", APPLICATION_NAME, parameters);

DocsService service = new DocsService(APPLICATION_NAME);
service.RequestFactory = requestFactory;

DocumentsListQuery query = new DocumentsListQuery();
DocumentsFeed feed = service.Query(query);
foreach (DocumentEntry entry in feed.Entries) {
  Console.WriteLine(entry.Title.Text);
}

RSA-SHA1와의 차이점은 액세스 토큰의 보안 비밀을 설정할 필요가 없고 서명자 객체를 구성하는 방식이 다르다는 점입니다.

RSA-SHA1 is not supported yet.

추가 3-Legged OAuth 리소스 및 샘플

Google Data API 도움말 블로그의 OAuth 예
도움말: Google Data API에서 OAuth 사용
Python 클라이언트 라이브러리 샘플
Python 클라이언트 라이브러리 Google App Engine 샘플
자바 클라이언트 라이브러리 샘플
자바 클라이언트 라이브러리 Google App Engine 샘플
Zend PHP 클라이언트 라이브러리 샘플
웹 애플리케이션용 OAuth 인증 문서
OAuth.net 문서

맨 위로

2-Legged OAuth

2 Leg OAuth를 사용하면 신뢰할 수 있는 애플리케이션에서 사용자의 개입 없이 사용자의 Google 데이터에 액세스할 수 있습니다. 2개의 주요 그룹에서 2-Legged OAuth를 사용할 수 있습니다.

G Suite 도메인 관리자: 관리자는 Google Data API를 통해 도메인의 사용자 데이터를 관리하는 스크립트 및 맞춤 애플리케이션을 구축할 수 있습니다. G Suite 도메인과 연결된 키 및 비밀번호를 관리하고 전역 액세스 제어를 부여하는 방법을 알아보려면 'OAuth 키 및 비밀번호 관리'를 참고하세요.

서드 파티 소프트웨어 공급업체: 공급업체는 2-Legged OAuth를 사용하여 G Suite와 통합하는 애플리케이션을 제공할 수 있습니다. 타사 애플리케이션에 대한 액세스 권한은 API 클라이언트 관리 페이지에서 부여하거나 G Suite Marketplace에서 설치할 수 있습니다.

일반적인 승인 과정 (3-Legged OAuth라고도 함)에 따라 액세스 토큰이 필요하지 않습니다.

다음 클라이언트 라이브러리 샘플은 HMAC-SHA1를 사용하여 2-Legged OAuth를 사용하도록 클라이언트를 설정하는 방법을 보여줍니다.

자바

import com.google.gdata.client.docs.*;
import com.google.gdata.client.authn.oauth.*;

String CONSUMER_KEY = "example.com";
String CONSUMER_SECRET = "abc123doremi";

GoogleOAuthParameters oauthParameters = new GoogleOAuthParameters();
oauthParameters.setOAuthConsumerKey(CONSUMER_KEY);
oauthParameters.setOAuthConsumerSecret(CONSUMER_SECRET);

DocsService client = new DocsService("yourCompany-YourAppName-v1");
client.setOAuthCredentials(oauthParameters, new OAuthHmacSha1Signer());

// Retrieve user's list of Google Docs
String user = "any.user@anydomain.com";
URL feedUrl = new URL("https://docs.google.com/feeds/default/private/full" +
                      "?xoauth_requestor_id=" + user);

DocumentListFeed resultFeed = client.getFeed(feedUrl, DocumentListFeed.class);
for (DocumentListEntry entry : resultFeed.getEntries()) {
  System.out.println(entry.getTitle().getPlainText());
}

PHP

require_once 'Zend/Oauth/Consumer.php';
require_once 'Zend/Gdata/Docs.php';

$CONSUMER_KEY = 'example.com';
$CONSUMER_SECRET = 'abc123doremi';
$USER = 'any.user@anydomain.com';

$oauthOptions = array(
    'requestScheme' => Zend_Oauth::REQUEST_SCHEME_HEADER,
    'version' => '1.0',
    'signatureMethod' => 'HMAC-SHA1',
    'consumerKey' => $CONSUMER_KEY,
    'consumerSecret' => $CONSUMER_SECRET
);

$consumer = new Zend_Oauth_Consumer($oauthOptions);
$token = new Zend_Oauth_Token_Access();
$httpClient = $token->getHttpClient($oauthOptions);

$client = new Zend_Gdata_Docs($httpClient);

// Retrieve user's list of Google Docs
$feed = $client->getDocumentListFeed('https://docs.google.com/feeds/default/private/full?xoauth_requestor_id=' . urlencode($USER));
foreach ($feed->entries as $entry) {
  echo "$entry->title\n";
}

Python

GDClient 기반의 최신 v2.0 이상 클래스를 사용하는 경우 다음을 사용합니다.

import gdata.gauth
import gdata.docs.client

CONSUMER_KEY = 'example.com'
CONSUMER_SECRET = 'abc123doremi'
requestor_id = 'any.user@anydomain.com'

client = gdata.docs.client.DocsClient(source='yourCompany-YourAppName-v1')
client.auth_token = gdata.gauth.TwoLeggedOAuthHmacToken(
    CONSUMER_KEY, CONSUMER_SECRET, requestor_id)

# Retrieve user's list of Google Docs
feed = client.GetDocList()
for entry in feed.entry:
  print entry.title.text

GDataService에 기반한 이전 v1.0 클래스를 사용하는 경우 다음을 사용합니다.

import gdata.auth
import gdata.docs.service

CONSUMER_KEY = 'example.com'
CONSUMER_SECRET = 'abc123doremi'
SIG_METHOD = gdata.auth.OAuthSignatureMethod.HMAC_SHA1

requestor_id = 'any.user@anydomain.com'

client = gdata.docs.service.DocsService(source='yourCompany-YourAppName-v1')
client.SetOAuthInputParameters(SIG_METHOD, CONSUMER_KEY, consumer_secret=CONSUMER_SECRET,
                               two_legged_oauth=True, requestor_id=requestor_id)

# Retrieve user's list of Google Docs
feed = client.GetDocumentListFeed()
for entry in feed.entry:
  print entry.title.text

# Change to another user on your domain
client.GetOAuthInputParameters().requestor_id = 'another.user@example.com'

.NET

using Google.GData.Client;
using Google.GData.Documents;

// Create an OAuth factory to use
GOAuthRequestFactory requestFactory = new GOAuthRequestFactory("writely", "yourCompany-YourAppName-v1");
requestFactory.ConsumerKey = "example.com";
requestFactory.ConsumerSecret = "abc123doremi";

String user = "any.user@anydomain.com";

DocumentsService client = new DocumentsService("yourCompany-YourAppName-v1");
client.RequestFactory = requestFactory;

// Retrieve user's list of Google Docs
DocumentsListQuery query = new DocumentsListQuery();
query.Uri = new OAuthUri("https://docs.google.com/feeds/default/private/full", user, requestFactory.ConsumerKey);

DocumentsFeed feed = client.Query(query);

foreach (DocumentEntry entry in feed.Entries)
{
  Console.WriteLine(entry.Title.Text);
}

추가 2-Legged OAuth 리소스 및 샘플

Google Data API 도움말 블로그의 2 다리 OAuth 예시
자바 클라이언트 라이브러리 2-Legged OAuth 샘플
Python 클라이언트 라이브러리 TWOLeggedOAuthExample (client.py 클래스의 경우) 또는 2_Leg_auth 샘플 (service.py 클래스의 경우)
.NET 클라이언트 라이브러리 2-Legged OAuth 샘플
2-Legged OAuth 문서

자체 서명 비공개 키 및 공개 인증서 생성

비공개 키는 각 요청에 포함되어야 하는 서명을 생성하는 데 사용됩니다. 인증서에 삽입된 공개 키는 Google에서 서명을 확인하는 데 사용됩니다. 공개 키는 PEM 형식의 X.509 인증서로 인코딩된 1024비트 RSA 키여야 합니다. 인증서는 등록 시 Google에 제출해야 합니다.

다음 섹션에서는 두 가지 특정 도구(OpenSSL 유틸리티와 자바의 keytool 유틸리티)를 사용하여 키와 인증서를 생성하는 방법을 보여주는 예시를 제공합니다.

이 예는 Google 데이터 API에만 국한되지 않습니다. 동일한 유틸리티를 사용하여 모든 용도로 키를 생성할 수 있습니다.

이 예에서는 회사의 이름이 My_Company이고 미국 캘리포니아주 마운틴뷰에 소재하고 도메인 이름은 example.com이라고 가정합니다.

OpenSSL을 사용하여 키 생성

다음 명령어를 사용하여 RSA 키 쌍과 해당 인증서를 만들 수 있습니다.

# Generate the RSA keys and certificate
openssl req -x509 -nodes -days 365 -newkey rsa:1024 -sha1 -subj \
  '/C=US/ST=CA/L=Mountain View/CN=www.example.com' -keyout \
  myrsakey.pem -out /tmp/myrsacert.pem

경고: -nodes 매개변수를 포함하면 비밀번호가 없는 비공개 키가 생성되어 보호됩니다. 그러나 보안을 강화하기 위해 이 매개변수를 생략하는 것이 좋습니다.

-sha1 매개변수는 SHA1 서명을 생성하는 데 키를 사용하도록 지정합니다.

-subj 매개변수는 인증서가 나타내는 애플리케이션의 ID를 지정합니다.

-keyout 매개변수는 키를 포함할 파일을 지정합니다. 이 파일에는 민감한 정보가 포함되어 있으며 보호되어야 하며 다른 사람과 공유해서는 안 됩니다.

-out 매개변수는 인증서를 PEM 형식(등록 시 Google에 전송할 수 있음)으로 포함할 파일을 지정합니다.

.NET 클라이언트 키 생성

.NET 프레임워크는 PEM 형식으로 저장된 키 또는 인증서를 이해하지 못합니다. 따라서 .pem 파일을 만든 후에는 추가 단계가 필요합니다.

openssl pkcs12 -export -in test_cert.pem -inkey myrsacert.pem -out myrsacert.pfx -name "Testing Certificate"

이 단계에서는 비공개 키 및 인증서에서 PFX 파일이 생성됩니다. 이 파일을 .NET 클라이언트 라이브러리로 가져와 Google 데이터 API에 대한 요청에 디지털 서명할 수 있습니다.

자바 클라이언트의 키 생성

자바 클라이언트는 PKCS#8 형식의 비공개 키를 허용합니다. 위의 안내를 사용하여 키/인증서를 생성한 후 생성된 .pem 파일에서 .pk8 파일을 만듭니다.

openssl pkcs8 -in myrsakey.pem -topk8 -nocrypt -out myrsakey.pk8

또는 자바 키 저장소와 keytool 유틸리티를 사용하여 RSA 키 쌍과 해당 인증서를 만들 수 있습니다. 다음 명령을 사용하세요.

# Generate the RSA keys and certificate
keytool -genkey -v -alias Example -keystore ./Example.jks\
  -keyalg RSA -sigalg SHA1withRSA\
  -dname "CN=www.example.com, OU=Engineering, O=My_Company, L=Mountain  View, ST=CA, C=US"\
  -storepass changeme -keypass changeme

경고: 'changeme'은(는) 좋은 비밀번호가 아니며 단지 하나의 예일 뿐입니다.

-dname 매개변수는 인증서가 나타내는 애플리케이션의 ID를 지정합니다. -storepass 매개변수는 키 저장소를 보호하는 비밀번호를 지정합니다. -keypass 매개변수는 비공개 키를 보호하기 위한 비밀번호를 지정합니다.

ManageDomains 도구에서 사용할 수 있는 파일에 인증서를 작성하려면 다음 명령어를 사용합니다.

# Output the public certificate to a file
keytool -export -rfc -keystore ./Example.jks -storepass changeme \
  -alias Example -file mycert.pem

맨 위로