보안 키 설정

콘솔 경로

➡️ 콘솔 경로: 앱센터 > 보안 키 설정

개요

보안 키 설정에서는 OAuth 2.0 인증 프로세스에서 클라이언트 애플리케이션을 식별하고, 서버와 클라이언트 간 요청을 검증하는 보안 키를 프로젝트별로 설정합니다.

유의사항

• 보안 키 설정은 인증 보안 프로토콜 변경으로 인해 SDK v4.25.0.0 이상 버전부터 필수로 적용해야 합니다.
• 보안 키를 설정하지 않으면 사용자가 앱에 로그인할 수 없습니다. 앱에 SDK v4.25.0.0 이상 버전을 적용했다면 반드시 보안 키를 설정하세요.
• 보안 키는 상용 환경과 샌드박스 환경에 각각 설정해야 합니다.

보안 키 확인

보안 키 설정 화면에서 프로젝트를 검색하면 발급된 보안 키를 확인할 수 있습니다.

Client Secret은 보안을 위해 최초 생성 시에만 한 번 표시됩니다. 생성 이후 페이지에 다시 진입하면 값이 마스킹 처리되며, API를 호출해도 Client Secret 값은 제공되지 않습니다.

Warning

• Client Secret은 생성 이후 다시 확인하거나 복사할 수 없습니다.
• 키를 생성한 직후 표시되는 Client Secret을 안전한 장소에 별도로 보관하세요.

보안 키 생성 및 삭제

보안 키 생성

1. 보안 키가 설정되어 있지 않으면 생성하기를 선택합니다.
2. 생성된 보안 키를 확인합니다.
3. 최초 생성 시 표시되는 Client Secret을 안전한 장소에 별도로 보관합니다.
4. 저장을 선택하여 보안 키를 저장합니다.

생성된 보안 키 중 Client ID는 편의를 위해 SDK 초기화 시 SDK에 저장됩니다.

Public Key와 Client ID는 각각 한 개만 생성할 수 있으며, 한 번 생성하면 변경할 수 없습니다. Client Secret은 동시에 최대 2개까지 발급하여 사용할 수 있습니다.

Client Secret 교체

기존 Client Secret을 확인할 수 없거나 키를 교체해야 하는 경우 다음 순서로 진행하세요.

1. 새로운 Client Secret을 추가로 발급합니다.
2. 서비스에서 신규 Client Secret을 사용하도록 변경합니다.
3. 신규 키로 정상적으로 전환되었는지 확인합니다.
4. 더 이상 사용하지 않는 기존 Client Secret을 삭제합니다.

신규 키와 기존 키를 함께 사용할 수 있으므로 서비스 중단 없이 Client Secret을 교체할 수 있습니다. 신규 키로 전환하기 전에 기존 키를 먼저 삭제하지 않도록 주의하세요.

변경 내역

보안 키 생성 및 삭제 이력은 변경 내역에서 확인할 수 있습니다.

보안 키 테스트

생성한 보안 키는 사용 전에 테스트할 수 있습니다. 앱센터 > 보안 키 테스트 IP 설정에서 IP를 등록하면, 해당 IP에서는 보안 키가 비활성화된 상태에서도 보안 키를 통한 통신이 가능합니다. 등록한 IP 주소는 프로젝트 단위로 관리됩니다.

IP 등록

• IP 주소는 숫자와 마침표(.)로만 구성된 IPv4 형식이어야 합니다. 입력 범위는 0.0.0.0부터 255.255.255.255까지입니다.
• 줄바꿈을 사용하여 여러 IP를 한 번에 등록할 수 있습니다.
• 동일한 IP를 중복 입력하면 하나만 등록되며, 이미 등록된 IP는 추가되지 않습니다.

IP 조회 및 삭제

• 등록된 IP는 IP 목록에서 확인할 수 있습니다.
• 각 IP 항목 오른쪽의 삭제를 선택하여 개별 삭제할 수 있습니다.