المهارات azure-communication-common-java
📦

azure-communication-common-java

آمن

Java에서 Azure Communication Services 인증 구현

Azure Communication Services 인증을 통합하려면 토큰 자격 증명과 사용자 식별자를 관리해야 합니다. 이 스킬은 ACS 서비스 전체에서 토큰 새로 고침, 식별자 처리 및 보안 인증을 위한 즉시 사용 가능한 패턴을 제공합니다.

يدعم: Claude Codex Code(CC)
🥉 75 برونزي
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "azure-communication-common-java". 서버 엔드포인트를 호출하는 토큰 새로 고침으로 자격 증명 만들기

النتيجة المتوقعة:

CommunicationTokenRefreshOptions refreshOptions = new CommunicationTokenRefreshOptions(this::fetchNewToken)
.setRefreshProactively(true)
.setInitialToken(initialToken);

CommunicationTokenCredential credential = new CommunicationTokenCredential(refreshOptions);

// The credential will automatically refresh tokens before expiration

استخدام "azure-communication-common-java". 이 원시 ID 구문 분석: 8:acs:resource_id_user_id

النتيجة المتوقعة:

CommunicationIdentifier identifier = parseIdentifier("8:acs:resource_id_user_id");
// Returns: CommunicationUserIdentifier
String userId = ((CommunicationUserIdentifier) identifier).getId();
// userId = "8:acs:resource_id_user_id"

التدقيق الأمني

آمن
v1 • 2/24/2026

Static analysis flagged 38 external_commands and 4 network patterns, but all are FALSE POSITIVES. The backtick patterns are Markdown code block delimiters (```java, ```xml), not shell execution. URLs are placeholder documentation examples. This is purely educational documentation for Azure Communication Services Java SDK with no security risks.

1
الملفات التي تم فحصها
310
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
50
المجتمع
100
الأمان
100
الامتثال للمواصفات

ماذا يمكنك بناءه

자동 새로 고침이 포함된 채팅 애플리케이션

만료 전에 액세스 토큰을 자동으로 새로 고치여 사용자의 중단 없는 통신을 보장하는 장기 실행 채팅 클라이언트를 구축합니다.

Entra ID를 통한 Teams 통합

적절한 범위 관리로 Phone Extensibility 시나리오에 대해 Azure AD를 사용하여 Teams 사용자를 인증합니다.

다중 식별자 사용자 관리

원시 ID에서 다양한 사용자 식별자 유형(ACS 사용자, 전화번호, Teams 사용자)을 통합된 방식으로 구문 분석하고 처리합니다.

جرّب هذه الموجهات

기본 토큰 자격 증명
엔드포인트 https://myresource.communication.azure.com을 사용하여 단기 실행 Chat 클라이언트를 위한 정적 사용자 액세스 토큰으로 CommunicationTokenCredential을 만드세요
사전 토큰 새로 고침
만료 전에 토큰 엔드포인트에서 새 토큰을 가져오는 Callable을 사용하여 사전 토큰 새로 고침으로 CommunicationTokenCredential을 설정하세요
Teams를 위한 Entra ID 인증
통화 관리를 위한 올바른 범위를 포함하여 Teams Phone Extensibility를 위해 InteractiveBrowserCredential을 사용하는 Azure AD 인증을 사용하여 CommunicationTokenCredential을 구성하세요
식별자 구문 분석 및 처리
원시 식별자 문자열을 구문 분석하여 적절한 CommunicationIdentifier 유형(CommunicationUserIdentifier, PhoneNumberIdentifier, MicrosoftTeamsUserIdentifier 또는 UnknownIdentifier)을 반환한 다음 각 유형을 적절하게 처리하는 메서드를 작성하세요

أفضل الممارسات

  • 활성 세션 중 인증 실패를 방지하려면 장기 실행 클라이언트에 대해 항상 setRefreshProactively(true)를 활성화하세요
  • 전체 액세스 토큰을 기록하거나 노출하지 마세요. 디버깅을 위해 잘린 부분만 표시하세요
  • 더 이상 필요하지 않을 때 리소스를 해제하려면 try-with-resources 또는 명시적 close()를 사용하여 자격 증명을 닫으세요

تجنب

  • 장기 실행 애플리케이션에서 새로 고침 없이 정적 토큰 사용 - 토큰이 만료되어 실패 발생
  • 전체 액세스 토큰 기록 또는 오류 메시지에 포함 - 보안 위험
  • 토큰 새로 고침 예외 무시 - 애플리케이션이 자동으로 인증을 잃음

الأسئلة المتكررة

토큰 새로 고침 콜백은 얼마나 자주 호출되나요?
setRefreshProactively(true)를 사용하면 SDK가 토큰 만료 전(일반적으로 토큰 수명의 50%)에 토큰을 새로 고침합니다. 사전 새로 고침 없이 만료 전에 수동으로 updateToken()을 호출해야 합니다.
CommunicationUserIdentifier와 PhoneNumberIdentifier의 차이점은 무엇인가요?
CommunicationUserIdentifier는 GUID와 같은 ID를 가진 ACS 사용자를 나타냅니다. PhoneNumberIdentifier는 E.164 형식의 PSTN 전화번호를 나타냅니다. ACS 사용자와 통신하는지 전화번호와 통신하는지에 따라 적절한 유형을 사용하세요.
익명 Teams 사용자를 어떻게 처리하나요?
MicrosoftTeamsUserIdentifier를 만들고 setAnonymous(true)를 호출하세요. 이는 사용자가 인증 없이 참여하는 Teams 모임 시나리오에 사용됩니다.
정부 클라우드의 Azure Communication Services에서 이 스킬을 사용할 수 있나요?
네. 식별자를 만들 때 미국 정부 커뮤니티 클라우드에는 CommunicationCloudEnvironment.GCCH을, 국방부 클라우드에는 CommunicationCloudEnvironment.DOD를 사용하세요.
토큰 새로 고침 콜백에서 예외가 발생하면 어떻게 되나요?
SDK가 새로 고침을 재시도합니다. 하지만 새로 고침이 계속 실패하면 자격 증명이 결국 만료됩니다. 새로 고침 콜백에 적절한 오류 처리 및 로깅을 구현하세요.
CommunicationTokenCredential을 삭제해야 하나요?
네. 완료되면 close()를 호출하거나 try-with-resources를 사용하세요. 이는 새로 고침 타이머를 중지하고 보유한 리소스를 해제합니다.

تفاصيل المطور

بنية الملفات

📄 SKILL.md