사용자 세션 관리

개요

App Services는 액세스 토큰 및 새로 고침 토큰을 사용하여 사용자 세션을 관리합니다. 액세스 토큰을 사용하면 해당 토큰이 있는 사람은 누구나 최대 30분 동안 연결된 세션을 사용할 수 있습니다. 새로 고침 토큰을 사용하면 이전 토큰이 이미 만료된 경우에도 세션에 대한 새 액세스 토큰을 생성할 수 있습니다.

Realm SDK는 사용자가 App Services에 연결할 때 자동으로 사용자 액세스 및 새로 고침 토큰을 관리합니다. 데이터 API와 같은 API 서비스에 연결하는 경우 세션을 직접 관리할 수 있습니다.

사용자 세션 액세스 토큰 가져오기

HTTPS를 통해 직접 사용자를 인증하고 사용자 액세스 토큰을 받거나 Realm SDK에서 관리하는 세션을 통해 이를 수행할 수 있습니다.

curl 'https://services.cloud.mongodb.com/api/client/v2.0/app/<App ID>/location'

{
  "deployment_model": "LOCAL",
  "location": "US-VA",
  "hostname": "https://us-east-1.aws.services.cloud.mongodb.com",
  "ws_hostname": "wss://ws.us-east-1.aws.services.cloud.mongodb.com"
}

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiYWFzX2RldmljZV9pZCI6IjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsImJhYXNfZG9tYWluX2lkIjoiNWVlYTg2NjdiY2I0YzgxMGI2NTFmYjU5IiwiZXhwIjoxNjY3OTQwNjE4LCJpYXQiOjE2Njc5Mzg4MTgsImlzcyI6IjYzNmFiYTAyMTcyOGI2YzFjMDNkYjgzZSIsInN0aXRjaF9kZXZJZCI6IjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsInN0aXRjaF9kb21haW5JZCI6IjVlZWE4NjY3YmNiNGM4MTBiNjUxZmI1OSIsInN1YiI6IjYzNmFiYTAyMTcyOGI2YzFjMDNkYjdmOSIsInR5cCI6ImFjY2VzcyJ9.pyq3nfzFUT-6r-umqGrEVIP8XHOw0WGnTZ3-EbvgbF0",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiYWFzX2RhdGEiOm51bGwsImJhYXNfZGV2aWNlX2lkIjoiMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwIiwiYmFhc19kb21haW5faWQiOiI1ZWVhODY2N2JjYjRjODEwYjY1MWZiNTkiLCJiYWFzX2lkIjoiNjM2YWJhMDIxNzI4YjZjMWMwM2RiODNlIiwiYmFhc19pZGVudGl0eSI6eyJpZCI6IjYzNmFiYTAyMTcyOGI2YzFjMDNkYjdmOC1ud2hzd2F6ZHljbXZycGVuZHdkZHRjZHQiLCJwcm92aWRlcl90eXBlIjoiYW5vbi11c2VyIiwicHJvdmlkZXJfaWQiOiI2MjRkZTdiYjhlYzZjOTM5NjI2ZjU0MjUifSwiZXhwIjozMjQ0NzM4ODE4LCJpYXQiOjE2Njc5Mzg4MTgsInN0aXRjaF9kYXRhIjpudWxsLCJzdGl0Y2hfZGV2SWQiOiIwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAiLCJzdGl0Y2hfZG9tYWluSWQiOiI1ZWVhODY2N2JjYjRjODEwYjY1MWZiNTkiLCJzdGl0Y2hfaWQiOiI2MzZhYmEwMjE3MjhiNmMxYzAzZGI4M2UiLCJzdGl0Y2hfaWRlbnQiOnsiaWQiOiI2MzZhYmEwMjE3MjhiNmMxYzAzZGI3Zjgtbndoc3dhemR5Y212cnBlbmR3ZGR0Y2R0IiwicHJvdmlkZXJfdHlwZSI6ImFub24tdXNlciIsInByb3ZpZGVyX2lkIjoiNjI0ZGU3YmI4ZWM2YzkzOTYyNmY1NDI1In0sInN1YiI6IjYzNmFiYTAyMTcyOGI2YzFjMDNkYjdmOSIsInR5cCI6InJlZnJlc2gifQ.h9YskmSpSLK8DMwBpPGuk7g1s4OWZDifZ1fmOJgSygw",
  "user_id": "636aba021728b6c1c03db7f9"
}

사용자 세션 액세스 토큰 새로 고침

액세스 토큰은 부여되고 30분 후에 만료됩니다. 액세스 토큰이 만료될 경우, 계속해서 요청을 보내려면 새 액세스 토큰을 받아야 합니다.

사용자를 다시 로그인하여 새 액세스 토큰을 얻을 수 있지만, 그러려면 사용자가 자격 증명을 다시 입력해야 합니다. 대신 사용자의 세션과 연결된 새로 고침 토큰을 사용하여 향후 30분 동안 유효한 새 액세스 토큰을 가져올 수 있습니다.

로그인에 성공한 후 액세스 토큰과 동일한 응답으로 새로 고침 토큰을 받습니다.

토큰 만료 새로 고침 구성

기본적으로 새로 고침 토큰은 발행 후 60일이 지나면 만료됩니다. 앱의 새로 고침 토큰 만료 간격을 30분에서 5년 사이로 구성할 수 있습니다.

익명 사용자 새로 고침 토큰은 만료 시간이 길고 사실상 만료되지 않습니다. 대신 익명 사용자 계정은 생성된 지 90일이 지나면 자동으로 삭제됩니다.

Admin UI 또는 Admin API에서 앱의 모든 세션에 대한 새로 고침 토큰 만료 시간을 구성할 수 있습니다.

curl -X PUT \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/refresh_token_expiration \
  --data-raw '{
    "expiration_time_seconds": 864000
  }'

& 사용자 액세스 토큰 디코딩 & 확인

액세스 토큰을 디코딩하여 형식이 올바른지, 서명이 유효한지 확인할 수 있습니다. 디코딩된 응답에는 액세스 토큰이 만료되는 시기 등 기타 정보가 포함됩니다.

요청 본문의 token 필드에 있는 토큰을 사용하여 앱의 액세스 토큰 관리자 API 엔드포인트를 확인하고 디코딩합니다 .

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/users/verify_token \
  --data-raw '{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJiYWFzX2RldmljZV9pZCI6IjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsImJhYXNfZG9tYWluX2lkIjoiNWNkYjEyNDA4ZTIzMmFjNGY5NTg3ZmU4IiwiZXhwIjoxNjc2NTExMjgyLCJpYXQiOjE2NzY1MDk0ODIsImlzcyI6IjYzZWQ4MTJhNDNiZTcyYzE3NmFhNWQyMyIsInN0aXRjaF9kZXZJZCI6IjAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMCIsInN0aXRjaF9kb21haW5JZCI6IjVjZGIxMjQwOGUyMzJhYzRmOTU4N2ZlOCIsInN1YiI6IjYzZWQ4MTJhNDNiZTcyYzE3NmFhNWQyMSIsInR5cCI6ImFjY2VzcyJ9.7kHO9wjWvIaD3VewDyPhLyb-oRc7wTYZdD9-hroF-H4"
  }'

{
  "sub": "63ed812a43be72c176aa5d21",
  "exp": 1676511282,
  "iat": 1676509482,
  "iss": "63ed812a43be72c176aa5d23",
  "domain_id": "5cdb12408e232ac4f9587fe8",
  "device_id": "000000000000000000000000"
}

토큰이 유효하면 200 응답을 받게 됩니다.

토큰이 유효하지만 만료된 경우 응답은 디코딩된 JWT를 포함하지 않고 토큰이 만료되었음을 나타냅니다.

"token expired"

토큰이 유효하지 않으면 오류 메시지가 포함된 401 응답을 받게 됩니다.

{
  "error": "signature is invalid"
}

사용자 세션 종료

세션이 설정되면 개별적으로 종료할 수 없지만 사용자의 모든 활성 세션을 취소할 수는 있습니다.

액세스 토큰 및 새로 고침 토큰의 모든 사본을 삭제하여 사용자 세션을 효과적으로 종료할 수 있습니다. 이렇게 하면 세션에 대한 추가 액세스가 방지되고 계속하려면 사용자가 인증하고 새 세션을 시작해야 합니다.

각 Realm SDK에는 액세스 토큰과 새로 고침 토큰의 로컬 사본을 삭제하고 새 액세스 토큰을 가져오는 데 사용할 수 없도록 새로 고침 토큰을 무효화하는 User.logOut() 메서드가 있습니다.

관리자나 사용자에 의해 사용자 계정이 삭제되면 사용자의 모든 세션이 자동으로 해지됩니다.

사용자 세션 해지

사용자의 현재 세션을 모두 해지할 수 있습니다. 이렇게 하면 세션 액세스 및 새로 고침 토큰이 무효화되고 사용자가 다시 로그인할 때까지 어떤 기기에서든 요청을 수행할 수 없습니다.

관리자나 사용자가 사용자 계정을 삭제하면 해당 사용자의 모든 세션이 자동으로 취소됩니다.