인증 지침¶

들어가며¶

Tweepy는 OAuth 1a(응용 프로그램-사용자)와 OAuth 2a(응용프로그램 전용)을 모두 지원합니다. 인증은 tweepy.AuthHandler 클래스를 통해 처리합니다.

OAuth 1a 인증¶

Tweepy는 OAuth 1a를 가능한 편리하게 제공하기 위해 노력합니다. 다만, 이 과정을 시작하기 위해선 클라이언트 응용프로그램을 트위터에 등록할 필요가 있습니다. 새로운 응용 프로그램을 생성하고, 그를 실행하기 위해서는 Consumer_key와 Secret을 가져야 합니다. 이 2가지는 필요하므로 잘 보관합시다.

아래 코드는 OAuthHandler 인스턴스를 생성하는 코드입니다. 여기에, 위에서 얻은 Consumer_key와와 Secret을 전달합니다:

auth = tweepy.OAuthHandler(consumer_key, consumer_secret)

웹 응용 프로그램이 있고 동적일 필요가 있는 콜백 URL을 사용하는 경우, 다음과 같이 전달합니다:

auth = tweepy.OAuthHandler(consumer_key, consumer_secret,
callback_url)

콜백 URL을 변경하지 않을 경우, 응용 프로그램의 프로필을 설정할 때 twitter.com에서 정적으로 설정하는 것이 가장 좋습니다.

기초적인 인증과는 다르게, 우리는 API를 사용하기 전에 다음의 "OAuth 1a Dance"과정이 거쳐야 합니다.다음와 같은 과정을 완벽하게 완료해야 합니다.

트위터에서 요청 토큰(Request Token)을 가져옵니다.
사용자를 twitter.com으로 리다이렉트 시켜, 응용 프로그램을 인증합니다.
콜백을 이용하는 경우, 트위터는 사용자를 우리에게 리다이렉트 할 것입니다. 그렇지 않으면 사용자가 수동으로 검증 코드를 입력해야만 합니다.
인증된 요청 토큰을 접근 토큰(Access Token)으로 교체합니다.

자, 이제 인증 과정을 진행하기 위해 요청 토큰을 가져옵시다.

try:
    redirect_url = auth.get_authorization_url()
except tweepy.TweepError:
    print('Error! Failed to get request token.')

이 호출은 트위터를 통하여 토큰을 요청하고, 사용자가 인증을 위해 리다이렉트 되어야 하는 인증 URL을 반환합니다. 만약 데스크탑 응용 프로그램인 경우, 사용자가 돌아올 때까지 OAuthHandler 인스턴스를 유지할 수 있습니다. 따라서, 요청 토큰은 콜백 URL 요청에 필요하므로 세션에 저장해야만 합니다. 다음은 요청한 토큰을 세션에 저장하는 예시 코드입니다:

session.set('request_token', auth.request_token['oauth_token'])

이제 get_authorization_url() 메소드를 통해, 이전에 반환받은 URL로 사용자를 리다이렉트 할 수 있습니다.

만약 데스크탑 응용 프로그램(또는 콜백을 사용하지 않는 응용 프로그램)이라면, 트위터의 승인 이후 제공되는 "검증 코드"를 사용자에게 요구해야 합니다. 웹 응용 프로그램 내에서 이 검증 코드는 URL에서 GET 쿼리 매개변수의 형태로 트위터의 콜백 요청에 의해 제공됩니다.

# Example using callback (web app)
verifier = request.GET.get('oauth_verifier')

# Example w/o callback (desktop)
verifier = raw_input('Verifier:')

마지막 단계는 요청 토큰을 접근 토큰으로 교체하는 것입니다. 접근 토큰은 트위터 API라는 보물 상자에 접근하기 위한 "열쇠"입니다. 이 토큰을 가져오기 위해서는, 다음과 같은 과정을 거쳐야합니다:

# Let's say this is a web app, so we need to re-build the auth handler
# first...
auth = tweepy.OAuthHandler(consumer_key, consumer_secret)
token = session.get('request_token')
session.delete('request_token')
auth.request_token = { 'oauth_token' : token,
                         'oauth_token_secret' : verifier }

try:
    auth.get_access_token(verifier)
except tweepy.TweepError:
    print('Error! Failed to get access token.')

차후 사용을 위해 접근 토큰을 저장하는 것은 좋은 생각입니다.이렇게 하면, 사용할 때 마다 계속 접근할 필요가 없어집니다. 트위터는 토큰을 만료시키지 않으므로, 비활성화 되는 때는 사용자가 응용 프로그램 접근을 취소할 때입니다. 접근 토큰을 저장하는 방법은 응용 프로그램에 따라 달라지지만, 기본적으로 Key와 Secret 문자열 값은 저장할 필요가 있습니다:

auth.access_token
auth.access_token_secret

토큰 값은 데이터베이스, 파일, 그 외 데이터 저장 장소에 저장이 가능합니다. 저장된 접근 토큰을 이용해, 다시 OAuthHandler를 실행하기 위해서는 다음과 같은 코드를 이용해야 합니다:

auth = tweepy.OAuthHandler(consumer_key, consumer_secret)
auth.set_access_token(key, secret)

OAuthHandler가 접근 토큰을 전달받았으므로, 이제 다음 코드를 실행할 수 있습니다:

api = tweepy.API(auth)
api.update_status('tweepy + oauth!')

OAuth 2 인증¶

Tweepy는 OAuth 2 인증 방식도 지원합니다. OAuth 2는 응용 프로그램이 사용자의 특별한 조작 없이도 API 요청을 할 수 있는 인증 방식입니다. 공개된 정보에 대한 읽기 전용 접근만이 필요한 경우 이 방식을 사용하세요.

물론 OAuth 1a처럼, 먼저 클라이언트 응용프로그램을 등록하고 Consumer_key와 Secret값을 얻어야 합니다.

그런 다음, AppAuthHandler 인스턴스를 생성하고, Consumer_key와 Secret을 전달합니다:

auth = tweepy.AppAuthHandler(consumer_key, consumer_secret)

토큰을 전달받았다면, 이제 작업을 시작할 준비가 되었습니다:

api = tweepy.API(auth)
for tweet in tweepy.Cursor(api.search, q='tweepy').items(10):
    print(tweet.text)