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

azure-communication-common-java

آمن

Implementar autenticação do Azure Communication Services em Java

Integrar a autenticação do Azure Communication Services requer gerir credenciais de token e identificadores de utilizador. Esta competência fornece padrões prontos a usar para atualização de tokens, gestão de identificadores e autenticação segura em todos os serviços ACS.

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

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

2

رفع في Claude

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

3

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

اختبرها

استخدام "azure-communication-common-java". Criar uma credencial com atualização de token que chama o meu endpoint de servidor

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

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

CommunicationTokenCredential credential = new CommunicationTokenCredential(refreshOptions);

// A credencial irá atualizar automaticamente os tokens antes da expiração

استخدام "azure-communication-common-java". Analisar este ID bruto: 8:acs:resource_id_user_id

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

CommunicationIdentifier identifier = parseIdentifier("8:acs:resource_id_user_id");
// Devolve: 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
الامتثال للمواصفات

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

Aplicação de Chat com Atualização Automática

Crie um cliente de chat de longa duração que atualiza automaticamente os tokens de acesso antes da expiração, garantindo comunicação ininterrupta para os utilizadores.

Integração Teams com Entra ID

Autentique utilizadores Teams usando Azure AD para cenários Phone Extensibility com gestão adequada de scopes.

Gestão de Utilizadores Multi-Identifier

Analise e trate diferentes tipos de identificadores de utilizador (utilizadores ACS, números de telefone, utilizadores Teams) de forma unificada a partir de IDs brutos.

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

Credencial de Token Básica
Criar uma CommunicationTokenCredential com um token de acesso de utilizador estático para um cliente Chat de curta duração usando o endpoint https://myresource.communication.azure.com
Atualização Proativa de Token
Configurar uma CommunicationTokenCredential com atualização proativa de token usando um Callable que obtém novos tokens do meu endpoint de token antes da expiração
Autenticação Entra ID para Teams
Configurar CommunicationTokenCredential usando autenticação Azure AD com InteractiveBrowserCredential para Teams Phone Extensibility, incluindo os scopes corretos para gestão de chamadas
Analisar e Processar Identificadores
Escrever um método que analisa uma string de identificador bruto e devolve o tipo CommunicationIdentifier apropriado (CommunicationUserIdentifier, PhoneNumberIdentifier, MicrosoftTeamsUserIdentifier ou UnknownIdentifier), depois processa cada tipo adequadamente

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

  • Ative sempre setRefreshProactively(true) para clientes de longa duração para prevenir falhas de autenticação durante sessões ativas
  • Nunca registe ou exponha tokens de acesso completos - mostre apenas porções truncadas para debugging
  • Feche as credenciais usando try-with-resources ou close() explícito quando não forem mais necessárias para libertar recursos

تجنب

  • Usar tokens estáticos sem atualização para aplicações de longa duração - os tokens expiram e causam falhas
  • Registar tokens de acesso completos ou incluí-los em mensagens de erro - risco de segurança
  • Ignorar exceções de atualização de token - a aplicação irá perder silenciosamente a autenticação

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

Com que frequência o callback de atualização de token é chamado?
Com setRefreshProactively(true), o SDK atualiza o token antes de expirar (tipicamente a 50% do tempo de vida do token). Sem atualização proativa, deve chamar updateToken() manualmente antes da expiração.
Qual é a diferença entre CommunicationUserIdentifier e PhoneNumberIdentifier?
CommunicationUserIdentifier representa um utilizador ACS com um ID tipo GUID. PhoneNumberIdentifier representa um número de telefone PSTN em formato E.164. Utilize o tipo apropriado com base se está a comunicar com utilizadores ACS ou números de telefone.
Como lido com utilizadores anónimos do Teams?
Crie um MicrosoftTeamsUserIdentifier e chame setAnonymous(true). Isto é usado para cenários de reuniões Teams onde os utilizadores acedem sem autenticação.
Posso usar esta competência com Azure Communication Services em nuvens governamentais?
Sim. Utilize CommunicationCloudEnvironment.GCCH para US Government Community Cloud ou CommunicationCloudEnvironment.DOD para Department of Defense cloud ao criar identificadores.
O que acontece se o meu callback de atualização de token lançar uma exceção?
O SDK irá tentar novamente a atualização. No entanto, se a atualização continuar a falhar, a credencial irá eventualmente expirar. Implemente tratamento de erros e logging adequados no seu callback de atualização.
Preciso de eliminar a CommunicationTokenCredential?
Sim. Chame close() quando terminar ou utilize try-with-resources. Isto para o temporizador de atualização e liberta quaisquer recursos guardados.

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

بنية الملفات

📄 SKILL.md