Python에서 Didit API 접근을 위한 OAuth 2.0 클라이언트 자격 증명 흐름 구현 (KO)

보안 API 접근OAuth 2.0 클라이언트 자격 증명 흐름 구현은 Didit API와의 서버 간 통신을 보호하고 민감한 신원 확인 데이터를 보호하는 데 필수적입니다.

Python 구현 가이드이 문서는 Didit API 호출을 위한 액세스 토큰을 획득하고 갱신하는 코드를 포함한 단계별 Python 가이드를 제공합니다.

속도 제한 이해Didit의 속도 제한 정책이 API 안정성을 어떻게 보호하는지, 그리고 서비스 중단을 피하기 위해 지수 백오프와 같은 모범 사례를 구현하는 방법을 알아보세요.

Didit의 개발자 우선 접근 방식Didit은 프로그래밍 방식 등록, 깔끔한 API 및 포괄적인 문서를 통해 진정한 개발자 우선 경험을 제공하여 통합을 간단하고 효율적으로 만듭니다.

API 접근을 위한 OAuth 2.0 클라이언트 자격 증명 흐름 이해

API 통합의 세계에서 보안은 가장 중요합니다. 애플리케이션이 사용자 개입 없이 서비스의 API에 직접 접근해야 할 때, OAuth 2.0 클라이언트 자격 증명 흐름은 보안 인증을 위한 업계 표준 방법입니다. 이 흐름은 최종 사용자가 데이터 접근에 동의할 필요가 없는 서버 간 상호 작용, 백그라운드 서비스 또는 기계 간 통신에 이상적입니다. 대신 애플리케이션 자체는 자체 자격 증명을 사용하여 인증됩니다.

Didit과 같은 강력한 신원 확인 플랫폼의 경우, API 접근 보안은 필수적입니다. 클라이언트 자격 증명 흐름은 승인된 애플리케이션만 ID 확인, 수동 및 능동 라이브니스, AML 심사와 같은 Didit의 강력한 신원 서비스 제품군과 상호 작용할 수 있도록 보장합니다. 이 방법은 클라이언트 ID와 클라이언트 시크릿(또는 API 키)을 단기 액세스 토큰과 교환하는 것을 포함하며, 이 토큰은 후속 API 요청을 승인하는 데 사용됩니다. 이러한 책임 분리는 모든 API 호출에서 장기 자격 증명의 직접적인 노출을 방지하여 보안을 강화합니다.

Didit 시작하기: 등록 및 자격 증명 검색

Didit은 AI 기반의 개발자 우선 신원 플랫폼임을 자랑합니다. 이는 프로그래밍 방식 접근을 위해서도 시작 과정이 최대한 원활하도록 설계되었음을 의미합니다. 수동 브라우저 기반 등록이 필요한 많은 플랫폼과 달리, Didit은 단 두 번의 API 호출만으로 자격 증명을 등록하고 검색할 수 있도록 합니다.

먼저, 일반적으로 이메일을 제공하여 등록 프로세스를 시작합니다. Didit은 해당 이메일로 OTP(일회용 비밀번호)를 보냅니다. 두 번째 단계는 OTP 코드로 이 이메일을 확인하는 것입니다. 성공적으로 확인되면 Didit은 자동으로 조직과 기본 애플리케이션을 생성하고 액세스 토큰, 클라이언트 ID, 그리고 중요한 api_key를 반환합니다. 이 api_key는 클라이언트 자격 증명 흐름을 위한 클라이언트 시크릿 역할을 하며 극비로 취급되어야 합니다.

또는 이미 조직과 애플리케이션이 있는 경우 Didit Auth API를 사용하여 자격 증명을 직접 검색할 수 있습니다. 예를 들어, /organizations/me/{org_id}/applications/{app_id}/에 대한 GET 요청을 사용하면 애플리케이션의 client_id와 api_key를 반환합니다. 이는 설정 프로세스를 간소화하여 개발자가 Didit의 모듈식 신원 기본 요소를 빠르게 통합하고 활용할 수 있도록 합니다.

Python에서 OAuth 2.0 클라이언트 자격 증명 흐름 구현

이제 Python을 사용하여 액세스 토큰을 얻는 실제 구현에 대해 알아보겠습니다. 핵심 아이디어는 Didit의 토큰 엔드포인트에 POST 요청을 보내 클라이언트 ID와 API 키를 제공하는 것입니다. 응답에는 액세스 토큰과 만료 시간이 포함됩니다.

import requests
import os

# Replace with your actual client_id and api_key
CLIENT_ID = os.environ.get("DIDIT_CLIENT_ID")
API_KEY = os.environ.get("DIDIT_API_KEY") # This is your client_secret

TOKEN_URL = "https://apx.didit.me/auth/v2/oauth2/token"

def get_access_token():
    headers = {
        "Content-Type": "application/x-www-form-urlencoded"
    }
    data = {
        "grant_type": "client_credentials",
        "client_id": CLIENT_ID,
        "client_secret": API_KEY
    }

    try:
        response = requests.post(TOKEN_URL, headers=headers, data=data)
        response.raise_for_status() # Raise an exception for HTTP errors
        token_data = response.json()
        return token_data.get("access_token"), token_data.get("expires_in")
    except requests.exceptions.RequestException as e:
        print(f"Error obtaining access token: {e}")
        return None, None

access_token, expires_in = get_access_token()

if access_token:
    print(f"Successfully obtained access token: {access_token[:30]}...")
    print(f"Token expires in: {expires_in} seconds")

    # Example of using the access token for a subsequent API call
    # (replace with an actual Didit API endpoint and method)
    # API_ENDPOINT = "https://apx.didit.me/api/v2/some-didit-service"
    # auth_headers = {
    #     "Authorization": f"Bearer {access_token}"
    # }
    # try:
    #     api_response = requests.get(API_ENDPOINT, headers=auth_headers)
    #     api_response.raise_for_status()
    #     print("API call successful:", api_response.json())
    # except requests.exceptions.RequestException as e:
    #     print(f"Error making API call: {e}")

이 Python 스니펫은 필요한 POST 요청을 만드는 방법을 보여줍니다. 예제에서와 같이 CLIENT_ID와 API_KEY를 환경 변수를 사용하여 안전하게 저장해야 합니다.

토큰 관리 및 속도 제한 고려 사항

액세스 토큰은 보안상의 이유로 일반적으로 수명이 짧습니다. 토큰이 만료되기 전에 갱신하는 전략을 구현하는 것이 중요합니다. 이는 일반적으로 토큰과 만료 시간을 저장한 다음, 현재 토큰이 만료될 때 새 토큰을 요청하는 것을 포함합니다. Didit의 토큰 응답에 있는 expires_in 필드는 토큰이 얼마나 오랫동안 유효한지 정확히 알려주므로 강력한 새로 고침 로직을 구축할 수 있습니다.

API 통합의 또 다른 중요한 측면은 속도 제한을 이해하고 준수하는 것입니다. Didit은 잘 설계된 모든 API와 마찬가지로 안정성을 유지하고 공정한 사용을 보장하기 위해 속도 제한을 적용합니다. 예를 들어, Didit은 일반적으로 GET 및 쓰기/삭제 엔드포인트 모두에 대해 애플리케이션당 분당 300개의 요청을 허용합니다. 세션 생성(POST /v2/session/)과 같은 영향이 큰 작업의 경우 특정하고 더 제한적인 제한(예: 워크플로우의 경우 600rpm)이 있을 수 있습니다. 애플리케이션이 이러한 제한을 초과하면 Didit은 429 Too Many Requests HTTP 상태 코드를 반환하며, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset(에포크 초)과 같은 유용한 헤더를 제공하여 스로틀링 전략을 안내합니다. Retry-After 헤더는 속도 제한 위반을 우아하게 처리하기 위한 권장 전략인 지수 백오프를 구현하는 데 특히 유용합니다.

적절한 토큰 관리 및 속도 제한 준수는 Didit과의 통합이 안전하고 신뢰할 수 있도록 보장하여 불필요한 서비스 중단을 방지합니다.

Didit이 도움이 되는 방법

Didit은 AI 기반의 개발자 우선 플랫폼으로 복잡한 신원 확인 문제를 단순화합니다. 모듈식 아키텍처를 통해 OCR, MRZ 및 바코드를 포함한 포괄적인 ID 확인, 딥페이크 방지를 위한 고급 수동 및 능동 라이브니스 감지, 생체 인증을 위한 1:1 얼굴 매치 및 얼굴 검색, 규정 준수를 위한 강력한 AML 심사 및 모니터링에 이르기까지 필요한 정확한 신원 확인을 플러그 앤 플레이할 수 있습니다. 당사의 주소 증명, 연령 추정(개인 정보 보호), 전화 및 이메일 확인 제품은 맞춤형 확인 워크플로우를 구축하는 능력을 더욱 향상시킵니다.

Didit은 무료 핵심 KYC를 제공하여 설정 비용을 없애고, 개발자를 위한 강력한 노코드 비즈니스 콘솔과 깔끔한 API를 제공하여 돋보입니다. 이러한 유연성은 API 기반 개발을 선호하든 시각적 워크플로우 빌더를 선호하든 관계없이 Didit을 기존 시스템에 쉽게 통합할 수 있음을 의미합니다. 구조화된 신원 데이터와 글로벌 디자인에 대한 우리의 약속은 귀하의 확인 프로세스가 전 세계적으로 효율적이고 확장 가능하며 규정을 준수하도록 보장합니다. 이 게시물에서 강조된 프로그래밍 방식 등록 및 자격 증명 검색은 Didit이 복잡한 인증 문제를 탐색하는 대신 구축에 집중할 수 있도록 원활한 개발자 경험을 우선시하는 한 예일 뿐입니다.

시작할 준비가 되셨습니까?

Didit이 작동하는 모습을 보실 준비가 되셨습니까? 오늘 무료 데모를 받으세요.

Didit의 무료 티어로 무료로 신원 확인을 시작하세요.