고급 - 진입 키 무효화

진입 키 무효화를 사용하면 특정 조건에서 대기 키와 진입 키를 선택적으로 무효화하여 방문자가 대기 순번 유지 또는 진입 패스로 보호되더라도 재대기해야 하도록 보장할 수 있습니다. 타이머 기반 무효화에서는 사용자 범위 지정 설정을 통해 진입 키만 또는 대기 키와 진입 키 모두를 무효화할 수 있습니다. 이 가이드는 무효화 메커니즘, 사용 사례 및 구성 옵션에 대해 설명합니다.

개요

진입 키 무효화는 특정 비즈니스 조건에서 방문자가 새 키를 받고 재대기해야 하도록 키를 강제로 무효화하는 메커니즘입니다. 무효화 대상은 무효화 유형과 설정에 따라 달라집니다: URL 기반 무효화는 진입 키만 무효화하고, 타이머 기반 무효화는 사용자 범위 지정 설정에 따라 진입 키만 또는 대기 키와 진입 키 모두를 무효화할 수 있습니다. 이 기능은 대기 순번 유지 및 진입 패스와 함께 작동하여 액세스 패턴에 대한 세밀한 제어를 제공합니다.

무효화가 필요한 이유

때로는 재대기를 강제해야 하는 비즈니스 시나리오가 있습니다:

• 공정한 액세스 제어: 중요한 단계에서 모든 방문자가 재대기하도록 보장
• 부하 관리: 특정 시간에 패스를 무효화하여 서버 부하 제어
• URL 기반 제한: 다른 서비스 엔드포인트 간 패스 공유 방지
• 이벤트 단계 전환: 다른 이벤트 단계로 이동할 때 재대기 강제

무효화되는 항목

진입 키 무효화는 두 가지 유형의 키에 영향을 줍니다:

1. 대기 키 (대기 순번에 사용):

• 무효화될 때: 대기 순번 유지가 우회됨
• 효과: 방문자가 대기 순번을 잃고 대기열 끝에서 시작해야 함 (대기 순번 유지 기간과 관계 없이)
• 사용 사례: 대기 순번 유지가 활성화되어 있어도 공정한 재대기 강제

2. 진입 키 (서비스 진입에 사용):

• 무효화될 때: 진입 패스가 우회됨
• 효과: 방문자가 대기실을 통해 재대기해야 함 (진입 패스 유효 기간과 관계없이)
• 사용 사례: 중요한 서비스 단계 또는 특정 URL에 대해 재대기 강제

작동 방식

진입 키 무효화는 간단한 원칙으로 작동합니다: 무효화 조건이 충족되면 키 재발급을 강제시키는 방식입니다. 이것은 방문자가 이전에 발급된 키에 의존하는 대신 대기실을 재방문하도록 합니다.

기술적 원칙

무효화 조건을 충족하는 키는 강제로 무효화되어 시스템이 새 키를 발급합니다. 이 절차는 대기 순번 유지 기간 또는 진입 패스 유효 기간과 관계 없이 작동합니다. 무효화 대상은 무효화 유형과 설정에 따라 다릅니다:

• URL 기반 무효화: 특정 URL에 액세스한 사용자의 진입 키만 무효화됩니다
• 타이머 기반 무효화: 사용자 범위 지정 설정에 따라 다르게 작동합니다
  • 진입한 사용자만: 서비스에 진입한 사용자의 진입 키만 무효화(재발급) (대기 중인 사용자의 대기 키는 영향받지 않음)
  • 대기중 사용자부터: 서비스에 진입한 사용자의 진입 키와 대기 중인 사용자의 대기 키를 모두 무효화(재발급) (대기 중인 사용자도 대기열 끝에서 재대기)
• 대기 키 무효화 시: 대기 순번 유지가 활성화되어 있고 대기 순번 유지 기간과 관계 없이, 연결이 끊어졌다가 다시 연결하는 방문자는 이전 대기 순번을 잃고 끝에서 시작
• 진입 키 무효화 시: 진입 패스가 활성화되어 있고 진입 패스 유효 기간 내에 있더라도, 무효화 조건이 충족되면 방문자는 진입 패스 유효 기간과 관계없이 재대기해야 함

1. URL 기반 무효화

방문자가 특정 URL에 액세스할 때 키를 무효화합니다.

사용 사례 예시: 선택적 액세스 제어가 있는 다중 페이지 이벤트

다음과 같은 세그먼트화된 이벤트가 있다고 가정합시다:

• 트리거 규칙: /event/1, /event/2, /event/3 경로가 대기실 트리거
• 진입 패스: 1시간 유효 기간
• 비즈니스 요구 사항: /event/3을 제외한 모든 이벤트 페이지는 진입 패스를 허용하지만, /event/3은 항상 재대기가 필요해야 함

시나리오 타임라인:

오전 10:00  방문자가 /event/1에 진입, 진입 키 수신
          → 진입 패스가 오전 11:00까지 1시간 동안 유효
          
오전 10:15  방문자가 /event/2에 액세스
          → 진입 패스가 여전히 유효함
          → 대기열 없이 직접 진입 ✓
          
오전 10:30  방문자가 /event/3에 액세스
          → URL 기반 무효화 트리거됨
          → 진입 키 무효화됨
          → 대기실을 다시 거쳐야 함 ✗
          
오전 10:31  방문자가 대기 후 새 진입 키 수신
          → /event/3에 액세스 허용됨 ✓

구성:

무효화하려는 서비스 경로의 전체 URL 경로 (프로토콜 포함)를 입력하세요:

https://example.com/event/3

기술적 세부 사항:

• UTI(URL 트리거 통합) 환경에서 작동
• 전체 경로 일치 필요 (프로토콜 + 도메인 + 경로)
• 세그먼트당 하나의 URL만 구성 가능
• 기본 제어 세그먼트에서만 사용 가능 (구간 제어 세그먼트에서는 지원되지 않음)

2. 타이머 기반 무효화

특정 시점 이전에 발급된 키를 자동으로 무효화합니다. 무효화 대상은 사용자 범위 지정 설정에 따라 결정됩니다.

사용 사례 예시: 중요한 단계에서 이벤트 공정성

다음과 같은 이벤트가 있다고 가정합시다:

• 진입 패스: 기본적으로 1시간 유효 기간
• 여러 이벤트 페이지(/event/1, /event/2, /event/3)가 1시간 내에 자유로운 탐색 허용
• 중요한 요구 사항: 오후 2:00 이후 모든 방문자는 이벤트 공정성을 위해 재대기해야 함

시나리오 타임라인:

오후 1:00   방문자가 /event/1에 진입, 진입 키 수신
          → 진입 패스가 오후 2:00까지 유효
          
오후 1:30   방문자가 /event/2로 이동
          → 진입 패스가 여전히 유효함
          → 직접 진입 ✓
          
오후 1:45   방문자가 /event/3으로 이동
          → 진입 패스가 여전히 유효함
          → 직접 진입 ✓
          
오후 2:00   타이머 기반 무효화 트리거됨
          → 예약 시간 이전에 발급된 키가 무효화됨
          
오후 2:05   방문자가 모든 이벤트 페이지에 액세스 시도
          → 오후 2:00에 키가 무효화됨
          → 대기실을 다시 거쳐야 함 ✗

구성:

1. 무효화 시간 설정 (최소 1분 단위):

   무효화 시간: 오후 2:00

2. 사용자 범위 지정:

   • 진입한 사용자만: 예약 시간 이전에 서비스에 진입한 사용자의 진입 키를 무효화(재발급)합니다. 대기 중인 사용자의 대기 키는 영향받지 않습니다.
   • 대기중 사용자부터: 예약 시간 이전에 서비스에 진입한 사용자의 진입 키와 진입을 위해 대기 중인 사용자의 대기 키를 모두 무효화(재발급)합니다.

작동 방식:

• 시스템이 각 키가 발급된 시점을 구성된 무효화 시간과 비교
• 무효화 시간 이전에 발급된 키는 사용자 범위 지정 설정에 따라 무효화됨 (대기 순번 유지 기간/진입 패스 유효 기간과 관계없이)
• 무효화 시간 이후에 발급된 키는 정상 동작
• 진입한 사용자만 선택 시: 서비스에 진입한 사용자의 진입 키만 무효화(재발급)되어 재진입 시 대기실을 거쳐야 함. 대기 중인 사용자의 대기 키는 영향받지 않음
• 대기중 사용자부터 선택 시: 서비스에 진입한 사용자의 진입 키와 대기 중인 사용자의 대기 키를 모두 무효화(재발급)하여 대기 중인 사용자도 대기열 끝에서 재대기해야 함

결합된 무효화

URL 기반 및 타이머 기반 무효화를 함께 사용하여 복잡한 액세스 제어 시나리오에 대응할 수 있습니다:

예시: URL 및 시간 제한이 모두 있는 이벤트

구성:
- URL 무효화: https://example.com/event/critical-phase
- 타이머 무효화: 오후 2:00

동작:
- 오후 2:00 이전: /event/critical-phase만 재대기 필요
- 오후 2:00 이후: 모든 페이지가 재대기 필요

구성

기본 동작

URL 기반 및 타이머 기반 무효화는 독립적인 설정으로 별도로 활성화하거나 비활성화할 수 있습니다:

• URL 기반 무효화 OFF (기본값): URL 기반 무효화가 발생하지 않음
• 타이머 기반 무효화 OFF (기본값): 타이머 기반 무효화가 발생하지 않음
• 두 기능을 독립적으로 활성화할 수 있음
• 무효화가 비활성화되면 키는 각각의 진입 패스 유효 기간에 따라 유효함

활성화된 경우:

• 각 액세스 시도에서 무효화 확인이 발생
• 활성화된 무효화 조건을 충족하는 키가 즉시 무효화됨
• 새 키는 대기실을 통해 받아야 함

구성 단계

기본 제어 세그먼트를 생성하거나 편집할 때 진입 키 무효화를 구성할 수 있습니다:

1. 세그먼트 설정으로 이동 (생성 또는 편집 모드)
2. 고급 설정 섹션으로 이동
3. 무효화 방법 활성화 (둘 다 독립적으로 활성화 가능):
   • URL 기반 무효화 활성화/비활성화
   • 타이머 기반 무효화 활성화/비활성화
4. 무효화 조건 구성:
   • URL 기반: 활성화된 경우 전체 URL 추가
   • 타이머 기반: 활성화된 경우 다음 설정 구성
     • 무효화 시간 설정 (최소: 1분 해상도)
     • 사용자 범위 지정 선택:
       • 진입한 사용자만: 서비스에 진입한 사용자의 진입 키를 무효화(재발급)
       • 대기중 사용자부터: 서비스에 진입한 사용자의 진입 키와 대기 중인 사용자의 대기 키를 모두 무효화(재발급)
5. 구성 저장: 설정 적용

세그먼트 유형 지원

기본 제어 세그먼트:

• URL 기반 및 타이머 기반 무효화 모두 사용 가능

구간 제어 세그먼트:

• 타이머 기반 무효화만 사용 가능
• URL 기반 무효화는 지원되지 않음 (UTI/트리거 규칙 지원 없음)

모범 사례

URL 기반 무효화 사용 시기

URL 기반 무효화를 사용하는 경우:

• 다른 페이지가 다른 액세스 수준을 요구함
• 일부 페이지가 더 중요하고 새로운 대기열이 필요함
• 진입 패스가 있어도 특정 페이지에 대한 사용자 액세스를 방지하려고 함
• 선택적 액세스 제어가 있는 다중 페이지 이벤트

예시 시나리오:

• 라이브 스트리밍 이벤트: 메인 페이지는 진입 패스를 허용하고, Q&A 페이지는 재대기 필요
• 다단계 판매: 둘러보기는 진입 패스를 허용하고, 구매 페이지는 재대기 필요
• 계층별 액세스: 무료 콘텐츠는 진입 패스를 허용하고, 프리미엄 콘텐츠는 재대기 필요

타이머 기반 무효화 사용 시기

타이머 기반 무효화를 사용하는 경우:

• 특정 이벤트 시간에 공정성이 중요함
• 예약된 간격으로 서버 부하를 제어해야 함
• 이벤트 단계가 고정된 시간에 전환됨
• 주기적인 재검증을 강제하려고 함

사용자 범위 지정 선택 가이드:

• 진입한 사용자만: 서비스에 진입한 사용자의 진입 키만 무효화하여 재진입 시 재대기하도록 하고, 대기 중인 사용자의 대기 키는 유지하여 순번을 보존하려는 경우
• 대기중 사용자부터: 서비스에 진입한 사용자의 진입 키와 대기 중인 사용자의 대기 키를 모두 무효화하여 예약 시간에 모든 사용자가 공정하게 재대기하도록 하려는 경우

예시 시나리오:

• 라이브 이벤트: 공연 시간에 재대기 강제 (대기중 사용자부터 권장)
• 제한된 출시: 초기 러시 기간 후 패스 무효화 (진입한 사용자만으로 충분할 수 있음)
• 예약된 세일: 각 세일 단계에 새로운 대기열 필요 (대기중 사용자부터 권장)
• 이벤트 전환: 재대기와 함께 워밍업에서 메인 이벤트로 이동 (대기중 사용자부터 권장)

통합된 방법

복잡한 이벤트 시나리오에서는 두 무효화 방식을 통합해 사용할 수 있습니다:

이벤트 구조:
- 워밍업 단계 (오전 10:00 - 오전 11:00): 프리미엄 콘텐츠에 대한 URL 기반 무효화
- 메인 이벤트 (오전 11:00 - 오후 12:00): 오전 11:00에 타이머 기반 무효화
- Q&A 단계 (오후 12:00 - 오후 1:00): Q&A URL에 대한 URL 기반 무효화

구성:
- URL 무효화: 
  * https://example.com/event/premium
  * https://example.com/event/qa
- 타이머 무효화: 오전 11:00

주의 사항

사용자 경험 고려:

• 너무 자주 무효화하면 사용자 경험에 부정적으로 작용함
• 가능한 경우 사용자에게 무효화 타이밍 전달
• 공정성과 사용성 사이의 균형 유지

시스템 부하 모니터링:

• 재대기 사용자의 급증이 트래픽 부하로 이어질 수 있음
• 과부하를 피하기 위해 무효화 타이밍 계획
• 무효화 시간 설정 전에 트래픽 패턴 고려

철저한 테스트 필요:

• 무효화 트리거가 예상대로 작동하는지 확인
• 대기 순번 유지 및 진입 패스 조합으로 테스트
• 사용자가 재대기가 필요함을 이해하는지 확인

다른 기능과의 상호 작용

대기 순번 유지 상호 작용

대기 순번 유지가 활성화되고 진입 키 무효화가 트리거될 때:

• URL 기반 무효화: 진입 키만 무효화되므로 대기 키는 영향받지 않습니다. 대기 중인 사용자의 대기 순번은 유지됩니다.
• 타이머 기반 무효화:
  • 진입한 사용자만: 서비스에 진입한 사용자의 진입 키만 무효화(재발급)되므로 대기 키는 영향받지 않습니다. 대기 중인 사용자의 대기 순번은 유지됩니다.
  • 대기중 사용자부터: 서비스에 진입하거나 진입을 위해 대기 중인 사용자의 대기 키와 진입 키를 모두 무효화(재발급)하여 사용자가 대기 순번을 잃고 끝에서 시작해야 합니다. 대기 순번 유지 기간 내에 있더라도 키 무효화가 우선순위를 가집니다.
• 새 키 발급: 무효화된 키의 경우 사용자가 새로운 키를 받고 뒤에서 대기열에 합류해야 합니다.

우선순위: 무효화 > 대기 순번 유지 (대기 키가 무효화되는 경우에만 적용)

진입 패스 상호 작용

진입 패스가 활성화되고 진입 키 무효화가 트리거될 때:

• 진입 키가 무효화됨: 사용자가 진입 패스 권한을 잃음
• 진입 패스 유효 기간이 우회됨: 진입 패스 유효 기간 내에 있더라도 무효화가 우선순위를 가짐
• 재대기 필요: 사용자가 대기실을 다시 거쳐야 함

우선순위: 무효화 > 진입 패스

결합된 보호 시나리오

시나리오 1: 진입 패스 기간 중 URL 무효화

진입 패스: 1시간 유효성
URL 무효화: /critical-page
타임라인:
  10:00 AM → 진입 패스 부여됨
  10:30 AM → /normal-page 액세스 (진입 패스 유효)
  10:45 AM → /critical-page 액세스 (URL 무효화 트리거, 재대기 필요)

시나리오 2: 대기 순번 유지 기간 중 타이머 무효화

대기 순번 유지 기간: 5분
타이머 무효화: 오전 10:28
사용자 범위 지정: 대기중 사용자부터
타임라인:
  10:25 AM → 사용자 연결 끊김 (대기 순번 #50 유지됨)
  10:28 AM → 타이머 무효화 트리거 (대기 키 무효화됨)
  10:29 AM → 사용자 재연결 (타이머가 이미 트리거됨)
              → 끝에서 재대기해야 함

시나리오 3: 타이머 무효화 - 진입한 사용자만

타이머 무효화: 오후 2:00
사용자 범위 지정: 진입한 사용자만
타임라인:
  1:30 PM → 사용자 A: 서비스 진입 완료 (진입 키 보유)
  1:45 PM → 사용자 B: 대기 중 (대기 키 보유, 순번 #10)
  2:00 PM → 타이머 무효화 트리거
          → 사용자 A: 진입 키 무효화됨 (재진입 시 대기 필요)
          → 사용자 B: 대기 키 유지됨 (순번 #10 유지)

검증

간단한 테스트로 진입 키 무효화 기능을 확인할 수 있습니다:

설정:

1. 30분 유효 기간으로 진입 패스 활성화
2. 진입 키 무효화 활성화 (URL 또는 타이머 기반)
3. 무효화 조건 구성

테스트 단계:

오전 10:00  방문자가 서비스에 진입, 진입 키 수신
          → 진입 패스가 오전 10:30까지 유효
          
오전 10:15  방문자가 서비스에 액세스
          → 진입 패스가 여전히 유효함
          → 직접 진입 ✓
          
오전 10:20  무효화 조건 충족 (URL 액세스 또는 타이머 트리거)
          → 진입 키 무효화됨
          
오전 10:25  방문자가 서비스 액세스 시도
          → 진입 키 무효화됨
          → 대기실을 다시 거쳐야 함 ✗
          → 재대기, 새 진입 키 수신
          
오전 10:26  방문자가 새 키로 서비스 액세스
          → 직접 진입 ✓ (새 진입 패스 발급됨)

테스트 목표:

• 무효화가 진입 패스 유효 기간보다 우선순위를 가짐을 확인
• 무효화된 키는 재사용할 수 없음을 확인
• 사용자가 대기실을 통해 새 키를 받아야 함을 확인
• 성공적인 재대기 후 새 진입 패스가 발급됨을 확인

FAQ

대기 순번 유지 또는 진입 패스 없이 무효화를 사용할 수 있나요?

네, 무효화는 독립적입니다. 그러나 무효화는 대기 순번 유지 및 진입 패스와 함께 사용할 때 최적의 효과를 발휘합니다. 사용자 보호를 언제 우회할지에 대한 세밀한 제어를 제공하기 때문입니다.

무효화를 여러 번 트리거하면 어떻게 되나요?

무효화는 이벤트 기반입니다: 키가 확인되고 무효화 조건을 충족할 때마다 무효화됩니다. 복잡한 시나리오를 위해 여러 무효화 조건(URL + 타이머)을 결합할 수 있습니다.

이미 활성화한 무효화를 비활성화할 수 있나요?

네! 진입 키 무효화 비활성화는 즉시 적용되는 실시간 변경입니다. 무효화된 키는 무효 상태로 유지되지만, 무효화를 비활성화한 후 발급된 새 키는 정상 동작합니다.

무효화는 모든 통합 유형에서 작동하나요?

URL 기반 무효화는 UTI(URL 트리거 통합)에서 작동합니다. 타이머 기반 무효화는 모든 통합 유형(UTI 및 CBI)에서 작동합니다.

대기 키와 진입 키를 별도로 무효화할 수 있나요?

타이머 기반 무효화에서는 사용자 범위 지정 설정을 통해 선택할 수 있습니다:

• 진입한 사용자만: 서비스에 진입한 사용자의 진입 키를 무효화(재발급)합니다. 대기 중인 사용자의 대기 키는 영향받지 않습니다.
• 대기중 사용자부터: 서비스에 진입하거나 진입을 위해 대기 중인 사용자의 대기 키와 진입 키를 모두 무효화(재발급)합니다.

URL 기반 무효화의 경우, 진입 키만 무효화됩니다 (URL에 액세스한 사용자의 진입 키만 무효화).

관련 구성 옵션은 고급 타이밍, 대기 순번 유지 및 진입 패스 문서를 참조하세요.