Roboflow로 로그인(시작하기)

OAuth 2.1 인가 코드 흐름과 PKCE를 사용하여 Roboflow 계정으로 사용자를 인증하는 애플리케이션을 구축할 수 있습니다. 이를 통해 앱은 승인된 권한 범위에 한해 Roboflow 사용자를 대신하여 동작할 수 있습니다.

OAuth 액세스 토큰은 api.roboflow.com 에서 Authorization: Bearer로 구성됩니다. REST API로 인증하기 를 참조하세요.

엔드포인트 표, 가시성, 오류 및 실행 가능한 샘플 앱은 Roboflow로 로그인(개발자 레퍼런스).

OAuth 앱 만들기

애플리케이션을 등록하려면:

1

개발자 설정 열기

다음으로 이동하세요. 워크스페이스 설정 > 개발자 를 Roboflow 대시보드에서 app.roboflow.com.

2

새 OAuth 앱 만들기

클릭하세요. OAuth 앱 만들기 (또는 새 앱)을 만들고 다음을 입력합니다:

필드

설명

이름

동의 화면과 OAuth 앱 목록에 표시되는 이름

홈페이지 URL

제품 URL(동의 화면에 표시되며 정보 제공용)

리디렉션 URI

하나 이상의 콜백 URL(코드와 정확히 일치해야 함)

토큰 엔드포인트 인증

클라이언트가 토큰 엔드포인트에 비밀키를 전송하는 방식: client_secret_post (요청 본문에 비밀키 포함, 기본값) 또는 client_secret_basic (HTTP Basic Authorization 헤더에 비밀키 포함). 대부분의 MCP 게이트웨이(Azure, TrueFoundry)는 client_secret_basic.

허용된 스코프

로그인 시 요청할 모든 스코프

가시성

내부, 비공개 목록또는 공개 - 참조 개발자 레퍼런스 - 가시성

다음 항목을 받게 됩니다. 클라이언트 ID 및 클라이언트 시크릿 (rfcs_…). 시크릿은 한 번만 표시되므로 서버에 안전하게 보관하세요.

리디렉션 URI 예시

공개 호스트에는 HTTPS가 필요합니다. HTTP는 루프백(localhost, 127.0.0.1, ::1).

인가 흐름

Roboflow는 PKCE(Proof Key for Code Exchange)가 포함된 인가 코드 그랜트를 사용합니다. PKCE는 모든 클라이언트에 필수입니다.

1

PKCE 코드 검증자와 챌린지 생성

무작위 code_verifier 를 생성하고(43~128자) 다음을 파생합니다. code_challenge 을 SHA-256을 사용해 다음과 같이 만듭니다:

복사

import hashlib, base64, secrets

code_verifier = secrets.token_urlsafe(32)
code_challenge = base64.urlsafe_b64encode(
    hashlib.sha256(code_verifier.encode()).digest()
).rstrip(b"=").decode()

2

사용자를 리디렉션하여 인가하기

사용자를 Roboflow 인가 엔드포인트로 보내세요:

복사

https://app.roboflow.com/oauth/authorize?
  client_id=YOUR_CLIENT_ID&
  redirect_uri=https://yourapp.com/callback&
  response_type=code&
  scope=openid profile email workspace:read&
  code_challenge=YOUR_CODE_CHALLENGE&
  code_challenge_method=S256&
  state=YOUR_STATE_VALUE

암호학적으로 안전한 무작위 state 를 사용하고 콜백에서 검증하세요. code_verifier 코드를 교환할 때까지 서버 측에 저장하세요.

사용자는 앱이 요청한 권한이 표시된 동의 화면을 보게 됩니다.

승인하면 Roboflow가 다음으로 리디렉션합니다. 리디렉션 URI 에서 코드 및 state.

3

코드를 토큰으로 교환하기

브라우저가 아닌 서버에서 토큰 엔드포인트로 POST 요청을 보내세요:

복사

curl -X POST https://app.roboflow.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=authorization_code" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "code=AUTHORIZATION_CODE" \
  -d "redirect_uri=https://yourapp.com/callback" \
  -d "code_verifier=YOUR_CODE_VERIFIER"

응답에는 다음이 포함됩니다:

• access_token - Roboflow API 호출(1시간 유효, MCP 클라이언트의 경우 24시간 유효)

• refresh_token - 새 액세스 토큰 획득(30일 유효)

• id_token - ID 클레임이 포함된 JWT( openid 가 요청된 경우)

OAuth 토큰 사용하기

액세스 토큰이 있으면 다음에 포함하여 보내세요. Authorization 헤더:

토큰 검증하기

불투명한 rfoa_ 액세스 토큰이 있고 클라이언트 자격 증명 없이 상태나 만료 여부를 확인해야 한다면 검증 엔드포인트를 호출하세요:

응답(항상 HTTP 200):

만료되었거나 취소된 토큰은 { "active": false, "exp": null, ... } HTTP 오류 대신 반환되므로 호출자는 유효하지 않은 토큰과 연결할 수 없는 인증 서버를 구분할 수 있습니다.

토큰 새로 고침

액세스 토큰은 1시간 후 만료됩니다(MCP 클라이언트의 경우 24시간). 새 토큰을 얻으려면 리프레시 토큰을 사용하세요:

토큰 폐기하기

액세스 토큰 또는 리프레시 토큰을 폐기하려면:

사용자 정보

인증된 사용자의 프로필 정보를 가져옵니다( openid):

사용 가능한 스코프

앱은 다음 스코프의 어떤 조합이든 요청할 수 있습니다. 각 스코프는 OAuth 앱의 허용된 스코프 목록

ID 스코프

API 스코프

OIDC 검색

Roboflow는 표준 OpenID Connect 검색 문서를 게시합니다:

• OpenID 구성: https://app.roboflow.com/.well-known/openid-configuration

• JWKS (ID 토큰 검증용): https://app.roboflow.com/.well-known/jwks.json

다음 단계

• Roboflow로 로그인(개발자 레퍼런스) - 호스트, 가시성, 오류, 예제 앱

• REST API로 인증하기