

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 3단계: 액세스 토큰 가져오기 및 API 요청
<a name="request"></a>

이 예에서는 액세스 토큰을 설정하는 단계를 안내한 다음, 기본 API 요청을 수행하는 방법을 보여줍니다. 이를 통해 Amazon DCV API로 구동되는 고급 애플리케이션 구축을 시작할 수 있는 기초 지식을 얻을 수 있습니다.

이 예에서는 `DescribeSessions` API를 사용하여 이 작업을 수행하는 방법을 살펴봅니다.

**Example**  
먼저 애플리케이션에 필요한 모델을 가져와야 합니다.  
그런 다음 포트 번호(`__PROTOCOL_HOST_PORT`)를 포함하여 클라이언트 ID(`__CLIENT_ID`), 클라이언트 암호(`__CLIENT_SECRET`) 및 브로커 URL에 대한 변수를 선언합니다.  
다음으로 클라이언트 자격 증명을 생성하는 함수(`build_client_credentials`)를 만듭니다. 클라이언트 자격 증명을 생성하려면 먼저 클라이언트 ID와 클라이언트 암호를 연결하고 콜론(`client_ID:client_password`)으로 값을 구분한 다음 전체 문자열을 Base64 형식으로 인코딩해야 합니다.  

```
import swagger_client
import base64
import requests
import json
from swagger_client.models.describe_sessions_request_data import DescribeSessionsRequestData
from swagger_client.models.key_value_pair import KeyValuePair
from swagger_client.models.delete_session_request_data import DeleteSessionRequestData
from swagger_client.models.update_session_permissions_request_data import UpdateSessionPermissionsRequestData
from swagger_client.models.create_session_request_data import CreateSessionRequestData

__CLIENT_ID = '794b2dbb-bd82-4707-a2f7-f3d9899cb386'
__CLIENT_SECRET = 'MzcxNzJhN2UtYjEzNS00MjNjLTg2N2YtMjFlZmRlZWNjMDU1'
__PROTOCOL_HOST_PORT = 'https://<broker-hostname>:8443'

def build_client_credentials():
    client_credentials = '{client_id}:{client_secret}'.format(client_id=__CLIENT_ID, client_secret=__CLIENT_SECRET)
    return base64.b64encode(client_credentials.encode('utf-8')).decode('utf-8')
```
이제 클라이언트 자격 증명이 확보되었으므로 이를 사용하여 브로커에 액세스 토큰을 요청할 수 있습니다. 이렇게 하려면 `get_access_token` 함수를 만듭니다. ` https://Broker_IP:8443/oauth2/token?grant_type=client_credentials`에 대해 `POST`를 직접 호출하고 Basic으로 인코딩된 클라이언트 자격 증명 및 `application/x-www-form-urlencoded` 콘텐츠 유형을 포함하는 권한 부여 헤더를 제공해야 합니다.  

```
def get_access_token():
    client_credentials = build_client_credentials()
    headers = {
        'Authorization': 'Basic {}'.format(client_credentials),
        'Content-Type': 'application/x-www-form-urlencoded'
    }
    endpoint = __PROTOCOL_HOST_PORT + '/oauth2/token?grant_type=client_credentials'
    print('Calling', endpoint, 'using headers', headers)
    res = requests.post(endpoint, headers=headers, verify=True)
    if res.status_code != 200:
        print('Cannot get access token:', res.text)
        return None
    access_token = json.loads(res.text)['access_token']
    print('Access token is', access_token)
    return access_token
```
이제 클라이언트 API를 인스턴스화하는 데 필요한 함수를 만듭니다. 클라이언트 API를 인스턴스화하려면 클라이언트 구성과 요청에 사용할 헤더를 지정해야 합니다. 이 `get_client_configuration` 함수는 브로커의 IP 주소 및 포트, 브로커 관리자로부터 받았어야 하는 브로커의 자체 서명 인증서 경로를 포함하는 구성 객체를 생성합니다. 이 `set_request_headers` 함수는 클라이언트 자격 증명 및 액세스 토큰이 포함된 요청 헤더 객체를 만듭니다.  

```
def get_client_configuration():
    configuration = swagger_client.Configuration()
    configuration.host = __PROTOCOL_HOST_PORT
    configuration.verify_ssl = True
    # configuration.ssl_ca_cert = cert_file.pem
    return configuration

def set_request_headers(api_client):
    access_token = get_access_token()
    api_client.set_default_header(header_name='Authorization',
                                  header_value='Bearer {}'.format(access_token))

def get_sessions_api():
    api_instance = swagger_client.SessionsApi(swagger_client.ApiClient(get_client_configuration()))
    set_request_headers(api_instance.api_client)
    return api_instance
```
마지막으로 `DescribeSessions` API를 직접적으로 호출하는 기본 메서드를 만듭니다. 자세한 내용은 [DescribeSessions](DescribeSessions.md) 섹션을 참조하세요.  

```
def describe_sessions(session_ids=None, next_token=None, tags=None, owner=None):
    filters = list()
    if tags:
        for tag in tags:
            filter_key_value_pair = KeyValuePair(key='tag:' + tag['Key'], value=tag['Value'])
            filters.append(filter_key_value_pair)
    if owner:
        filter_key_value_pair = KeyValuePair(key='owner', value=owner)
        filters.append(filter_key_value_pair)

    request = DescribeSessionsRequestData(session_ids=session_ids, filters=filters, next_token=next_token)
    print('Describe Sessions Request:', request)
    api_instance = get_sessions_api()
    api_response = api_instance.describe_sessions(body=request)
    print('Describe Sessions Response', api_response)
    
def main():
    describe_sessions(
        session_ids=['SessionId1895', 'SessionId1897'],
        owner='an owner 1890',
        tags=[{'Key': 'ram', 'Value': '4gb'}])
```