SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

مصادقة Claude API: مفتاح، Bedrock، Vertex، Foundry

تعرّف على طرق المصادقة الأربع في Claude API على خادم VPS باستخدام مفتاح Anthropic أو AWS IAM أو Google ADC أو Microsoft Entra، واحفظ بيانات اعتماد الخادم بأمان.

مسارات مصادقة Claude API

تتوقف مصادقة Claude API على قرار واحد: أي بيانات اعتماد يضعها العميل في طلب الشبكة. تسرد Anthropic واجهة Claude API المباشرة، إضافة إلى خمس منصات سحابية: Amazon Bedrock، وClaude Platform on AWS، وClaude Models on Google Cloud (Google managed)، وClaude Models on Google Cloud (Anthropic managed)، وMicrosoft Foundry. تقبل واجهة Anthropic API المباشرة مفتاح API أو رمزاً قصير الأجل في ترويسة Authorization: Bearer، وما زالت تقبل مفاتيح API في ترويسة x-api-key القديمة. يدعم Amazon Bedrock توقيع طلبات AWS ومفاتيح Bedrock API، ولا يوجد مفتاح Anthropic في هذا الإعداد. يرسل Google Cloud رمز وصول قصير الأجل من Google. ويقبل Microsoft Foundry مفتاحاً صادراً عن Azure أو رمز Microsoft Entra. تغطي الأقسام الأربعة أدناه إعدادات بيانات الاعتماد هذه، مع شرح عرضَي AWS وGoogle Cloud اللذين تديرهما Anthropic إلى جانب نظيريهما السحابيَّين.

هذا الدليل مخصص لربط SDK (حزمة تطوير البرمجيات) بخدمة تعمل على خادم Linux. إذا كنت تضبط أداة سطر الأوامر Claude Code بدلاً من ذلك، فالمتغيرات والتدفق مختلفان: راجع توجيه Claude Code إلى Bedrock أو Vertex. إذا لم تكن الخدمة موجودة بعد، فأنشئها أولاً باتباع إنشاء أول تطبيق Claude API على VPS، ثم عد إلى هنا لإضافة بيانات الاعتماد.

تم التحقق من كل ما يلي مقابل وثائق منصة Anthropic في August 2026، ثم أُعيد التحقق منه مقابل وثائق كل موفر في 16 October 2026؛ كما أُعيد التحقق من تفاصيل الوصول إلى نماذج Bedrock مقابل وثائق AWS في 19 October 2026. وأُعيد التحقق من صفحات Anthropic الخاصة بالمسارات الأربعة، ومفاتيح API، وإصدارات API في 27 October 2026. كما أُعيد التحقق في 10 November 2026 من صفحات Anthropic الخاصة بـMicrosoft Foundry، ونقطتي نهاية Bedrock، والمسار المُدار من Google، وClaude Platform on AWS، والمصادقة، وWorkload Identity Federation، وإصدارات API، إلى جانب سجل تغييرات Ruby SDK. تتغير معرّفات النماذج والأسعار وإصدارات SDK وبُنى نقاط النهاية باستمرار، لذلك يربط هذا الدليل بصفحات الموفّرين بدلاً من طباعة قيم قد تصبح قديمة.

المسار 1: مفتاح Anthropic API

هذا هو المسار المباشر، وهو المسار الوحيد الذي تصدر فيه Anthropic السر. تُرسل الطلبات إلى نقطة نهاية Messages على مضيف API الخاص بـAnthropic، وتحمل كل طلب ثلاثة رؤوس.

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "MODEL_ID", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

استبدل MODEL_ID بمعرّف حالي من نظرة عامة على النماذج لدى Anthropic. تكون الاستجابة السليمة بتنسيق JSON وتحتوي على مصفوفة content وكائن usage. يعيد المفتاح الخاطئ أو المنتهي HTTP 401 مع authentication_error. ويؤدي غياب رأس anthropic-version إلى فشل منفصل، لأن هذا الرأس مطلوب في كل طلب؛ وتتولى SDKs ضبطه لك. اعتباراً من أكتوبر 2026، تعرض وثائق Anthropic Authorization: Bearer باعتباره الطريقة الرئيسية لإرسال المفتاح، وتصف x-api-key بأنه قديم، لكن كليهما مقبول، لذلك يظل الأمر أعلاه يعمل. ترسل الإصدارات الرئيسية الحالية من SDKs المفتاح أيضاً بصيغة Authorization: Bearer، لذلك يجب تغيير أي proxy أو gateway يقرأ X-Api-Key عند الترقية. يظل إصدار 2023-06-01 في الأمر مقبولاً؛ أما أحدث إصدار من API لدى Anthropic فهو 2026-10-21، وترسله إصدارات SDKs تلك افتراضياً، كما أنه يرفض بعض معاملات الطلبات الأقدم مثل temperature.

يُعد إنشاء العميل الأقصر بين هذه الإعدادات، لأنه لا يوجد شيء تحتاج إلى إنشائه. تقرأ كل SDK رسمية ANTHROPIC_API_KEY من البيئة تلقائياً.

import os
from anthropic import Anthropic

client = Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model=os.environ["CLAUDE_MODEL"],
    max_tokens=64,
    messages=[{"role": "user", "content": "Hello"}],
)
print(message.usage)

من المفيد الاحتفاظ بمعرّف النموذج في البيئة إلى جانب المفتاح. تتغير أسماء النماذج وفق جدول زمني لا تتحكم فيه، ويمكن تجنب إعادة نشر الشيفرة لتعديل سلسلة واحدة.

تُنشأ المفاتيح في Console، حيث تختار مدة الانتهاء وقت الإنشاء: إعدادات مسبقة مدتها 3 ساعات أو 1 يوم أو 7 أيام أو 30 يوماً، أو مدة مخصصة، أو Never، وفق الحد الأقصى لسياسة انتهاء الصلاحية في مؤسستك. تُحدَّد مدة الانتهاء وقت الإنشاء ولا يمكن تغييرها لاحقاً. ترسل Anthropic رسالة بريد إلكتروني إلى منشئ المفتاح قبل انتهاء مفتاح طويل الأجل، لكن المفتاح قصير الأجل ينتهي من دون إرسال أي رسالة تحذير. يعيد المفتاح المنتهي 401 ولا يمكن إعادة تفعيله، لذلك يكون الحل دائماً إنشاء مفتاح جديد.

لا توجد منطقة تختارها في API المباشر، وتُرسل الفاتورة مباشرة إلى مؤسستك في Anthropic. تحدد Workspaces نطاق المفتاح ليقتصر على مشروع واحد، وهذه أوضح طريقة لمعرفة ما تنفقه خدمة واحدة. حدّد نطاق مفتاح الخادم ليقتصر على Workspace الخاص به عند إنشائه: يجب على مفتاح حساب شخصي أو حساب خدمة غير المحدد نطاقه إلى Workspace إرسال رأس anthropic-workspace-id في كل طلب، وإلا تعيد API استجابة 400 مع invalid_request_error. بالنسبة إلى الخدمة، اختر مفتاح حساب خدمة، لأن المفتاح الشخصي يتوقف عن العمل عندما يغادر منشئه المؤسسة. للاطلاع على الحسابات وراء هذه الفاتورة، راجع مقارنة تسعير API لكل رمز مع الاشتراك.

يوجد خيار آخر مناسب هنا، لأنه يلغي السر الثابت تماماً. تتيح Workload Identity Federation لحِمل العمل مبادلة رمز OpenID Connect (OIDC) من موفر هوية تثق به مسبقاً برمز Anthropic قصير الأجل عبر POST /v1/oauth/token، وتتولى SDK تحديث هذا الرمز قبل انتهائه. ولا يتم إنشاء سلسلة sk-ant-api... أو نسخها في أي مكان. يناسب ذلك Kubernetes وGitHub Actions وVMs السحابية، التي تحمل بالفعل هوية للمنصة. أما VPS عادي فعادةً فلا يملك موفر الرموز هذا، لذلك يكون مفتاح API في ملف هو الحل الواقعي على ذلك الخادم، وهذا ما يفترضه باقي هذا الدليل.

المسار 2: بيانات اعتماد AWS على Amazon Bedrock

في Bedrock، لا تحتاج إلى أي مفتاح Anthropic. باستخدام بيانات اعتماد AWS، يوقّع SDK كل طلب HTTP باستخدام AWS Signature Version 4 (SigV4)، وتحدد AWS ما إذا كان يمكن لذلك المتصل استدعاء النموذج.

pip install -U "anthropic[bedrock]"
aws sts get-caller-identity

يطبع aws sts get-caller-identity رقم الحساب وARN (Amazon Resource Name) للهوية التي تُحل إليها بيانات اعتمادك. شغّله قبل أي شيء آخر عند استخدام SigV4. في SigV4، يحل SDK بيانات اعتماد المُنشئ، وبيانات اعتماد البيئة، وسلسلة بيانات اعتماد AWS القياسية؛ أما اختيار المنطقة فهو منفصل. في عميل Python ‏AnthropicBedrock، يؤدي تمرير مفتاح Bedrock API باعتباره api_key أو عبر AWS_BEARER_TOKEN_BEDROCK إلى رفع ValueError إذا مرّرت أيضاً aws_access_key أو aws_secret_key أو aws_session_token أو aws_profile. من دون هذه الوسائط الصريحة، يختار المفتاح مصادقة bearer بدلاً من سلسلة بيانات اعتماد AWS. يعطي عميل TypeScript الأولوية لمفتاح Bedrock API على بيانات اعتماد AWS الصريحة. ولا يختبر أمر STS مصادقة bearer.

ما يتغير في إنشاء العميل هو الفئة ووسيط واحد.

from anthropic import AnthropicBedrock

client = AnthropicBedrock(aws_region="us-east-1")

يتولى AnthropicBedrock تكامل InvokeModel في Bedrock. اعتباراً من October 2026، توثّق Anthropic أيضاً Claude في Amazon Bedrock، مع نقطة نهاية Messages API في https://bedrock-mantle.{region}.api.aws/anthropic/v1/messages لنموذج Claude Opus 4.7 والنماذج الأحدث، ويمكن الوصول إليها عبر عميل AnthropicBedrockMantle من الحزمة نفسها. وهو يدعم بيانات اعتماد AWS ورموز Bedrock bearer؛ وتختلف متطلبات الوصول إلى النموذج بين نقطتي النهاية، كما هو موضح أدناه.

انتبه إلى الترقية في السطر pip install -U. اعتباراً من 27 October 2026، يرسل أحدث SDK إصدار API ‏2026-10-21 افتراضياً، بما في ذلك عبر Bedrock، وتوثّق Anthropic أن معرّفات النماذج التي تتضمن ARN وتدرجها لـ Claude Opus 4.6 والإصدارات الأقدم لا تدعم ذلك الإصدار على Bedrock، وقد تعيد خطأ 400. إذا كانت خدمة ما تستدعي أحد هذه النماذج، فأبقِ SDK على الإصدار الذي تستخدمه حالياً وثبّته، أو انقل الخدمة أولاً إلى نموذج Claude 4.7 أو أحدث.

لا تعود المنطقة مجرد إعداد شكلي هنا. نقاط نهاية Bedrock خاصة بكل منطقة، وتختلف نماذج Claude المتاحة من منطقة إلى أخرى، كما تدخل المنطقة في توقيع SigV4؛ لذلك يرفض نطاق مختلف توقيعاً حُسب لمنطقة أخرى. عيّن AWS_REGION صراحةً في بيئة الخدمة، لأن SDKs لا تتفق على السلوك عند تركه من دون تعيين. وفقاً للتوثيق في October 2026، يقرأ عميل Python ‏AnthropicBedrock القيمة AWS_REGION أو AWS_DEFAULT_REGION، ثم يقرأ منطقة جلسة boto3 أو ملف تعريف AWS، بما في ذلك ~/.aws/config، ويرفع ValueError إذا لم تُحل أي قيمة. يقرأ عميل TypeScript القيمة AWS_REGION، ويستخدم us-east-1 عند عدم تعيينها، ولا يقرأ ~/.aws/config للمنطقة. لذلك يمكن لـ AWS CLI عرض نماذج Claude بنجاح على الجهاز نفسه الذي تستدعي فيه عملية Node المنطقة الخطأ: فقد قرأ CLI ملف الإعداد، بينما لم يقرأه العميل.

على مثيل EC2، تربط دور IAM (إدارة الهوية والوصول) ولا تُحفظ أي قيمة سرية على القرص، لأن خدمة بيانات تعريف المثيل تسلّم SDK بيانات اعتماد مؤقتة. أما VPS خارج AWS فلا يملك دور مثيل ولا خدمة بيانات تعريف. عندها تختار بين زوج مفاتيح وصول طويل الأمد لمستخدم IAM محفوظ على الجهاز، وهو من الفئة نفسها من الأسرار التي ينتمي إليها مفتاح Anthropic، وبين الاتحاد: تصادق مقابل موفر هويتك، وتستدعي AWS STS (خدمة الرموز الأمنية)، ثم تستخدم بيانات الاعتماد المؤقتة التي يعيدها. يقبل Bedrock أيضاً مفاتيح Bedrock API، وهي رموز bearer تُمرَّر عبر AWS_BEARER_TOKEN_BEDROCK، وتوثّق AWS نوعين منها. يستمر المفتاح قصير الأمد حتى 12 hours، أو طوال مدة الجلسة التي أنشأته إذا كانت أقصر، ويرث صلاحيات هوية IAM التي أنشأته؛ وهذا هو النوع الذي توصي به AWS للإنتاج. يستمر المفتاح طويل الأمد حتى تاريخ انتهاء تختاره عند إنشائه، مثل 30 أو 90 days باستخدام --credential-age-days، أو لا تنتهي صلاحيته إذا حُذفت وسيطة API تلك؛ وتنشئ Console مستخدم IAM خلفه، ولا توصي AWS به إلا للاستكشاف. لا يعمل المفتاح طويل الأمد إلا في المنطقة التي أُنشئ فيها؛ ويؤدي استخدامه في منطقة أخرى إلى إعادة Credential should be scoped to a valid region.

تُسجَّل الفاتورة على حساب AWS الخاص بك بدلاً من Anthropic، وهذا عادةً هو السبب الرئيسي لاختيار هذا المسار. تفرض نقاط النهاية الإقليمية زيادة قدرها 10% على نقطة النهاية العامة، وفقاً للتوثيق في October 2026. أما Claude Platform على AWS فهو منتج منفصل: تديره Anthropic، وتفوتره AWS عبر AWS Marketplace، ويصادق باستخدام SigV4 أو مفتاح API يُنشأ في AWS Console؛ ولا تعمل مفاتيح Claude Console هناك. ويُستخدم لذلك عميل AnthropicAWS الذي تصنّفه Anthropic على أنه تجريبي. هناك خطأ في Bedrock يستحق التمييز، لأنه يبدو كأنه مشكلة صلاحيات لكنه ليس كذلك: Invocation of model ID ... with on-demand throughput isn't supported. Retry your request with the ID or ARN of an inference profile that contains this model. هذه مشكلة في توجيه النموذج، ولن يحلها تغيير بيانات الاعتماد.

المسار 3: بيانات اعتماد Google على Vertex AI

تسمّي وثائق Anthropic هذا المسار الآن Claude Models on Google Cloud (Google managed)، وتديره Google ضمن Agent Platform، وهو الاسم الجديد لما تطوّر من Vertex AI. يظل كل من المضيف aiplatform.googleapis.com، والإضافة anthropic[vertex]، والصنف AnthropicVertex المعروض أدناه من دون تغيير.

تستخدم Google Cloud بيانات اعتماد التطبيق الافتراضية (ADC)، وهي ترتيب بحث ثابت تتبعه مكتبات مصادقة Google للعثور على بيانات اعتماد من دون تحديدها يدوياً. تتحقق ADC أولاً من GOOGLE_APPLICATION_CREDENTIALS، ثم من الملف الذي يكتبه gcloud auth application-default login، ثم من حساب الخدمة المرتبط عبر خادم metadata.

pip install -U "anthropic[vertex]"
gcloud auth application-default login

على محطة العمل، يكتب تسجيل الدخول $HOME/.config/gcloud/application_default_credentials.json، وبذلك تكتمل العملية. على الخادم، تجنّب تخزين بيانات اعتماد مستخدم بشري؛ إذ يدعم الأمر أيضاً انتحال هوية حساب خدمة. خارج Google Cloud، لا يتوفر خادم Google metadata، لذا استخدم GOOGLE_APPLICATION_CREDENTIALS لتوجيه ADC إلى ملف إعداد Workload Identity Federation أو إلى ملف مفتاح حساب خدمة. ملف JSON الخاص بمفتاح حساب الخدمة سر طويل الأجل، ويحتاج إلى المعالجة الموضحة لاحقاً في هذا الدليل تحديداً. داخل Google Cloud، اربط حساب خدمة بالآلة الافتراضية، ولن يكون هناك ملف يحتاج إلى الحماية. أياً كانت الهوية التي تعثر عليها ADC، يجب أن تتضمن أدوار IAM الخاصة بها الإذن aiplatform.endpoints.predict، مثل Agent Platform User (roles/aiplatform.user).

from anthropic import AnthropicVertex

client = AnthropicVertex(project_id="my-project", region="global")

يتغير أمران إذا انتقلت من SDK إلى HTTP الخام. ينتقل معرّف النموذج من جسم الطلب إلى مسار URL، وينتقل anthropic_version من الرأس إلى الجسم. اعتباراً من 27 October 2026، تقبل وثائق Anthropic هناك إما vertex-2023-10-16 أو إصدار API الأحدث 2026-10-21. بيانات الاعتماد هي Google access token عادية. في الأمر أدناه، يستخدم gcloud auth print-access-token تسجيل الدخول الخاص بواجهة gcloud CLI بدلاً من ADC، لذا شغّل gcloud auth login أو gcloud init أولاً على الجهاز الذي تختبر عليه الأمر.

curl https://aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/global/publishers/anthropic/models/${MODEL_ID}:rawPredict \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -d '{"anthropic_version": "vertex-2023-10-16", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

المنطقة وسيط أساسي في الطلب. يوجّه global الطلبات ديناميكياً وفق التوافر، بينما يحدد us وeu مناطق متعددة، ويثبت اسم مثل us-east5 منطقة واحدة. اعتباراً من October 2026، توثّق Anthropic نقاط نهاية المناطق الواحدة فقط لـ Claude Sonnet 4.6 والإصدارات الأقدم؛ أما النماذج الأحدث فتستخدم نقاط النهاية العالمية أو متعددة المناطق. تكلّف نقاط النهاية متعددة المناطق والإقليمية 10% أكثر من النقاط العالمية، وفق ما هو موثق في October 2026. تتم الفوترة من خلال مشروع Google Cloud، لذلك تتولى Google الحصة والفواتير.

اعتباراً من 27 October 2026، توثّق Anthropic أيضاً عرضاً ثانياً في Google Cloud، ويختلف شكل طلبه. في Claude Models on Google Cloud (Anthropic managed)، تدير Anthropic واجهة Claude API نفسها على claude.googleapis.com، ويمكن الوصول إليها عبر عميل AnthropicGoogleCloud. ويظل هذا العرض يستخدم بيانات اعتماد Google Cloud، بما في ذلك ADC، لكن الطلب يشبه واجهة API المباشرة: يبقى model في الجسم، وينتقل الإصدار في الرأس anthropic-version. يأتي الوصول من أدوار IAM الخاصة به (roles/claude.user وما يرتبط بها)، وينشئ الإعداد مؤسسة Anthropic جديدة للمشروع، وتتم فوترة الاستخدام عبر Google Cloud Marketplace. إذا كانت عناوين URL لطلباتك تحتوي على aiplatform وتنتهي بـ :rawPredict، فأنت تستخدم مسار Google-managed الذي يصفه هذا القسم.

المسار 4: Microsoft Foundry هو مسار Azure

إذا بحثت عن Claude على Azure، فهذا هو القسم المطلوب، ويوجد مسار مدعوم فعلاً. يعمل Claude في Microsoft Foundry (المعروف سابقاً باسم Azure AI Foundry)، وتتم فوترته عبر Azure Marketplace بوحدات Claude Consumption Units. أنشئ مورداً في Foundry، وانشر نموذج Claude داخله، ثم استدعِ نقطة نهاية مستضافة على Azure في https://{resource}.services.ai.azure.com/anthropic/v1/*.

تعمل بيانات اعتماد اثنتين. الأولى مفتاح صادر عن Azure من علامة التبويب Details الخاصة بالنشر في بوابة Foundry، ويُرسل في ترويسة api-key أو x-api-key. والثانية رمز Microsoft Entra، وهو الخيار الأفضل على الخادم لأن التحكم في الوصول المستند إلى الأدوار في Azure يحدد عندئذ من يمكنه استدعاء نقطة النهاية.

ACCESS_TOKEN=$(az account get-access-token --resource https://ai.azure.com --query accessToken -o tsv)

curl https://${RESOURCE}.services.ai.azure.com/anthropic/v1/messages \
  -H "content-type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -d '{"model": "DEPLOYMENT_NAME", "max_tokens": 64, "messages": [{"role": "user", "content": "Hello"}]}'

يحمل الحقل model اسم النشر، وليس معرّف نموذج. يتطابق الاسمان افتراضياً، لكنهما يتوقفان عن التطابق فور تسمية النشر يدوياً، وهذا هو السبب المعتاد لخطأ Deployment not found في طلب صحيح من النواحي الأخرى. يقرأ Python وTypeScript SDK المتغيرين ANTHROPIC_FOUNDRY_API_KEY وANTHROPIC_FOUNDRY_RESOURCE من البيئة. ووفقاً للوثائق في 10 November 2026، يشمل دعم Foundry حزم SDK الرسمية السبع كلها: C# وGo وJava وPHP وPython وRuby وTypeScript. يستخدم Go الحزمة المخصصة foundry (go get github.com/anthropics/anthropic-sdk-go/v2/foundry)، وأضاف Ruby النوع المخصص Anthropic::FoundryClient في الإصدار 2.5.0 من الحزمة، الذي صدر في 4 November 2026. قبل ذلك الإصدار، كان على شيفرة Ruby توجيه العميل العام إلى عنوان Foundry الأساسي.

ينطوي توجيه عميل عام إلى عنوان Foundry الأساسي على نقطة خطرة، سواء كانت شيفرة Ruby مكتوبة قبل 2.5.0 أو أداة CLI ant، التي توجّه أمثلة Foundry الخاصة بـAnthropic إليها بهذه الطريقة. إذا لم تمرر بيانات الاعتماد إلى العميل العام صراحةً، وبقي ANTHROPIC_API_KEY أو ANTHROPIC_AUTH_TOKEN مضبوطاً في البيئة، فسيقرأه العميل ويرسل بيانات اعتماد Anthropic إلى نقطة نهاية تابعة لـMicrosoft. ألغِ ضبط المتغير، أو مرّر مفتاح Foundry أو الرمز إلى العميل صراحةً. في Ruby، يُعد الانتقال إلى Anthropic::FoundryClient، الذي يقبل مفتاح Foundry أو موفّر رموز Entra، الحل الأنظف. يحصل رمز وصول Entra على مدة صلاحية افتراضية عشوائية تتراوح بين 60 و90 دقيقة، لذلك يجب على العملية طويلة التشغيل تجديده بدلاً من الاحتفاظ برمز واحد عند بدء التشغيل.

ما مدة صلاحية بيانات الاعتماد الموجودة على خادمك؟

رسم بيانيDocumented credential lifetime by route, hours
البيانات وراء هذا الرسم البياني
[
  {
    "label": "Anthropic key, 30-day preset",
    "max_lifetime_hours": 720
  },
  {
    "label": "Anthropic key, 7-day preset",
    "max_lifetime_hours": 168
  },
  {
    "label": "AWS STS assumed role",
    "max_lifetime_hours": 12
  },
  {
    "label": "Bedrock short-term API key",
    "max_lifetime_hours": 12
  },
  {
    "label": "Entra ID access token, default upper bound",
    "max_lifetime_hours": 1.5
  },
  {
    "label": "Federated Anthropic token, default",
    "max_lifetime_hours": 1
  }
]

هذه حدود قصوى وقيم افتراضية ينشرها كل مزوّد، وقد قُرئت في أكتوبر 2026، وليست قياسات فعلية. وتهم لسبب واحد: فهي توضح المدة التي تظل فيها بيانات الاعتماد المسرّبة صالحة للاستخدام، بينما لا تزال تتحقق من حدوث التسريب. يستمر رمز Anthropic المميّز في الاتحاد، الموجود أسفل المخطط، لمدة تصل افتراضياً إلى 1 ساعة، ويُقيَّد أيضاً بضعف المدة المتبقية من صلاحية رمز مزوّد الهوية. لا يملك رمز وصول Microsoft Entra قيمة افتراضية واحدة؛ إذ يمنح Microsoft كل رمز مدة صلاحية عشوائية بين 60 و90 دقيقة، بمتوسط 75 دقيقة، وتظهر في المخطط عند الحد الأعلى البالغ 1.5 ساعة. كما تختلف هذه القيمة الافتراضية باختلاف العميل والمورد، وبحسب تفعيل Conditional Access في المستأجر. عندما يدعم كل من العميل والمورد ميزة Continuous Access Evaluation، قد تمدد Entra مدة الصلاحية إلى 24 إلى 28 ساعة، وتلغي الرمز في وقت قريب من الفعلي عند وقوع أحداث مثل تعطيل الحساب. ويمكن لسياسة مدة صلاحية الرموز على مستوى المستأجر ضبطها على أي قيمة من 10 دقائق إلى 23:59:59. تُحدّث SDKs رموز Anthropic المميّزة في الاتحاد تلقائياً. أما على Foundry، فاضبط موفّر رموز Entra لتحديث الرموز بدلاً من تمرير سلسلة رمز ثابتة. ويمكن لقاعدة الاتحاد ضبط مدة صلاحية الرمز الخاصة بها على أي قيمة من دقيقة واحدة إلى 24 ساعة. كما يملأ معالج Connect workload في Console قيمة 10 دقائق مسبقاً، لذلك اقرأ القاعدة بدلاً من افتراض القيمة الافتراضية. يستمر كل من الدور المفترض ومفتاح Bedrock قصير الأجل لواجهة API لمدة 12 ساعتين. لا يظهر مفتاح Bedrock طويل الأجل لواجهة API في المخطط لأنه لا يملك حداً أقصى ثابتاً؛ إذ يستمر حتى تاريخ الانتهاء الذي تحدده عند إنشائه، أو لا تنتهي صلاحيته إذا حُذف CredentialAgeDays من استدعاء API. ولهذا توصي AWS باستخدامه للاستكشاف فقط. يظل المفتاح الذي أُنشئ باستخدام الإعداد المسبق لمدة 30 يوماً صالحاً لمدة 720 ساعة، وهو بيانات الاعتماد التي تبقى في ملف على خادمك لمدة شهر.

مكان حفظ بيانات الاعتماد على VPS

ضع السر في ملف لا يستطيع قراءته إلا root، ودَع systemd يمرّره إلى العملية. يظل هذا الإعداد صالحاً عبر إصدارات SDK كلها، لذلك يجدر تنفيذه مرة واحدة وبشكل صحيح.

sudo useradd --system --home /opt/claude-app --shell /usr/sbin/nologin claudeapp
sudo install -d -m 700 -o root -g root /etc/claude-app
sudo install -m 600 -o root -g root /dev/null /etc/claude-app/env
sudoedit /etc/claude-app/env

يحتوي الملف على أسطر KEY=value نصية عادية. لا تستخدم export أو علامات اقتباس أو صياغة shell، لأن systemd يحلّل الملف بنفسه بدلاً من تمريره إلى shell.

ANTHROPIC_API_KEY=sk-ant-api03-REPLACE-ME
CLAUDE_MODEL=REPLACE-ME
[Unit]
Description=Claude API service
After=network-online.target

[Service]
User=claudeapp
EnvironmentFile=/etc/claude-app/env
ExecStart=/opt/claude-app/venv/bin/python -m claude_app
Restart=on-failure

[Install]
WantedBy=multi-user.target

يقرأ systemd ملف EnvironmentFile= بصفته root قبل أن ينتقل إلى User=claudeapp، لذلك لا يحتاج حساب الخدمة إلى صلاحية قراءة الملف. يكفي أن يكون الملف مملوكاً لـroot وبوضع 600، ولهذا يضبطه الأمر install أعلاه بهذه الطريقة. شغّل الخدمة باستخدام sudo systemctl enable --now claude-app، ثم تأكد عبر systemctl status claude-app من أن الوحدة وصلت إلى الحالة active (running) بدلاً من إعادة التشغيل في حلقة.

تجنّب الأمور الأربعة التالية، ولكل منها سبب يمكنك التحقق منه بنفسك:

  • لا تكتب المفتاح باستخدام Environment= داخل ملف الوحدة. تكون الوحدة الموجودة تحت /etc/systemd/system قابلة للقراءة من جميع المستخدمين، لذلك يعرض systemctl cat claude-app السر لأي مستخدم محلي.
  • لا تودعه في المستودع. يُبقي .gitignore الملف الجديد خارج الالتزام، لكنه لا يفعل شيئاً بشأن ملف سبق إدراجه في التزام، لأن سجل git يحتفظ بكل ما أُضيف إليه.
  • لا تضعه داخل صورة حاوية. تستمر قيم ENV في إعدادات الصورة، وتظهر وسيطات البناء في سجل الصورة أو بيانات مصدرها. حذف الملف في طبقة لاحقة لا يزيله من الطبقة السابقة. مرّر الأسرار وقت التشغيل باستخدام --env-file أو باستخدام ملف موصول بدلاً من ذلك.
  • لا تعتبر بيئة العملية خاصة بالنسبة إلى root. يعرض sudo cat /proc/$(pgrep -u claudeapp -f claude_app | head -1)/environ | tr '\0' '\n' المفتاح مجدداً. يحتاج أمر قراءة الملف نفسه إلى sudo؛ إذ يُنفَّذ توجيه إدخال shell قبل sudo ويستخدم صلاحيات حسابك الحالي. الهدف هو إبقاء السر بعيداً عن كل حساب آخر على الخادم، وليس بعيداً عن root، الذي يستطيع قراءته مهما فعلت.

توضح النقطة الأخيرة حدود ما يوفّره هذا التصميم. يحمي الملف المقصور على root المفتاح المخزّن، لكن أي كود يعمل بحساب الخدمة يستطيع قراءة بيئة العملية، كما ترثها العمليات الابنة. ويكون هذا التصميم غير مناسب عندما تشغّل العملية كوداً لم تكتبه، لأن أي شيء تستطيع العملية تنفيذه يستطيع قراءة بيئتها الخاصة. يشرح إبعاد الأسرار عن متناول وكيل ذكاء اصطناعي هذه الحالة، وهي مشكلة مختلفة لها إجابة مختلفة.

كيف أدوّر المفتاح من دون توقّف الخدمة؟

دوّر المفتاح الجديد أولاً، وألغِ القديم أخيراً. تؤدي إعادة تشغيل الخدمة الوحيدة أدناه إلى انقطاع قصير في الخدمة؛ ولضمان التوافر المستمر، يجب أن يتولى مثيل آخر معالجة الطلبات أثناء إعادة التشغيل.

  1. أنشئ المفتاح الجديد في Console، ضمن مساحة العمل نفسها التي يوجد فيها المفتاح القديم.
  2. اكتب المفتاح في /etc/claude-app/env باستخدام sudoedit.
  3. شغّل sudo systemctl restart claude-app.
  4. تأكد من أن الخدمة تستجيب للطلبات، ثم ألغِ المفتاح القديم في Console.

تُقرأ قيمة EnvironmentFile عند بدء الوحدة، لذلك يحتفظ process قيد التشغيل بالقيمة التي مُرِّرت إليه عند الإقلاع. أما systemctl daemon-reload فيعيد قراءة ملفات الوحدات ولا يغيّر بيئة process قيد التشغيل، لذلك لا يلتقط المفتاح الجديد إلا بعد إعادة التشغيل. إذا ألغيت المفتاح في الخطوة 1 بدلاً من الخطوة 4، فستتسبب في انقطاع يستمر حتى الخطوة 3.

تُدوَّر بيانات اعتماد cloud routes لدى المزوّد. يدعم مستخدم IAM مفتاحي وصول نشطين في الوقت نفسه، لذلك أنشئ المفتاح الثاني، وانشره، ثم احذف الأول. ويُدوَّر مفتاح حساب خدمة Google بالطريقة نفسها. يحمل مورد Foundry مفتاحين، وتؤدي إعادة إنشاء أحدهما إلى إيقاف عمل قيمته القديمة فوراً، لذلك انقل الخدمة إلى المفتاح الآخر قبل إعادة إنشاء المفتاح الذي كانت تستخدمه. لا تحتاج رموز Entra ورموز Anthropic الموحّدة إلى تدوير يدوي، وهذا أقوى سبب لاستخدامها حيثما أمكنك ذلك.

أثناء وجودك في Console، عيّن حدّاً للإنفاق على مساحة العمل. يكون المفتاح المسرّب مكلفاً قبل أي شيء آخر، ويوضح تحديد ما يمكن لـagent على VPS إنفاقه عناصر التحكم اللازمة لذلك.

لماذا يعيد عميلي 401 أو 403؟

401 مع authentication_error في API المباشر. المفتاح غير صحيح، أو أُلغي، أو انتهت صلاحيته. انتهاء الصلاحية هو السبب الذي يفوته الناس، لأن الشيفرة لم تتغير وكان الطلب يعمل أمس. تحقق من عمود انتهاء صلاحية المفتاح في Console، أو اقرأ expires_at من Admin API، حيث تكون قيمته null للمفاتيح التي لا تنتهي صلاحيتها. يتوقف المفتاح الشخصي أيضاً عن العمل عندما يغادر مالكه المؤسسة.

يتجاهل SDK إعداد federation ويستخدم مفتاحاً بدلاً منه. يأتي ANTHROPIC_API_KEY وANTHROPIC_AUTH_TOKEN قبل federation في ترتيب أولوية بيانات الاعتماد، لذلك يحجب أيٌّ منهما إعداد federation. وتظهر المشكلة بوضوح في الحالة التالية: يظل المتغير الذي تصدّره كسلسلة فارغة محتلاً موضعه، لذلك يجعل ANTHROPIC_API_KEY="" SDK يصادق باستخدام مفتاح فارغ بدلاً من الانتقال إلى الخيار التالي. استخدم unset ANTHROPIC_API_KEY.

401 مع الرسالة المجردة Authentication failed في federation. هذه الرسالة متطابقة عمداً مع جميع الأسباب المحتملة، حتى لا يتمكن المستدعي من استكشاف إعدادات القواعد بقراءة نص الخطأ. يُسجَّل السبب الحقيقي في صفحة سجل المصادقة في Console. ابدأ من هناك بدلاً من التخمين بشأن JWT.

403 على Foundry. صادَق الرمز بنجاح، لكن حسابك في Azure لا يملك دوراً يسمح بتنفيذ الطلب. عيّن دوراً من أدوار Azure RBAC، مثل Foundry User (المعروف سابقاً باسم Azure AI User) أو Cognitive Services User، إلى الهوية التي تنفذ الطلب.

أي خطأ على Bedrock. بالنسبة إلى مصادقة SigV4، شغّل aws sts get-caller-identity أولاً بصفة مستخدم الخدمة. يجيب ذلك عمّا إذا كان الخادم يملك بيانات اعتماد AWS قابلة للاستخدام، ويفصل بين مشكلة بيانات الاعتماد ومشكلة الوصول إلى النموذج أو عدم تطابق المنطقة. اعتباراً من 29 October 2026، تفعّل AWS الوصول إلى العديد من النماذج عند أول استخدام في المناطق التجارية، مع توفر أذونات AWS Marketplace المطلوبة، لكن بعض النماذج تتطلب وصولاً منفصلاً على مستوى الحساب. تتطلب نماذج Anthropic التي تُستدعى عبر مسار InvokeModel تعبئة نموذج حالة استخدام لمرة واحدة لكل حساب (أو مرة واحدة لمؤسسة AWS بأكملها، مع أن المناطق التي تتطلب الاشتراك تحتاج إلى ذلك مرة أخرى) أولاً، وإلى أن تتم الموافقة عليه يعيد الطلب AccessDeniedException. توضح AWS أن النموذج لا ينطبق على نقطة النهاية bedrock-mantle. يؤدي أول طلب إلى نموذج في حساب أيضاً إلى بدء Bedrock اشتراك AWS Marketplace في الخلفية، ويتطلب هذا الاشتراك هوية تملك أذونات aws-marketplace:Subscribe وaws-marketplace:Unsubscribe وaws-marketplace:ViewSubscriptions. لا تؤدي الأذونات المفقودة بالضرورة إلى فشل الطلب الأول: توضح AWS أن الطلبات قد تنجح لمدة تصل إلى 15 minutes أثناء إعداد الاشتراك، وبعد فشل الاشتراك تعيد الطلبات اللاحقة AccessDeniedException نفسه. إذا توقفت خدمة كانت تعمل خلال الدقائق الأولى عن العمل بعد ذلك، فابحث في هذا الموضع بدلاً من افتراض أن المشكلة في بيانات اعتمادها. بعد منح الأذونات، تتيح AWS مدة تصل إلى 2 minutes لاكتمال الاشتراك. يفشل النموذج غير المتاح في المنطقة التي تستدعيه، مهما كانت جودة بيانات الاعتماد.

FAQ

هل أحتاج إلى مفتاح API من Anthropic لاستخدام Claude على Bedrock أو Vertex؟

لا. في Amazon Bedrock، يوقّع SDK الطلبات باستخدام بيانات اعتماد AWS عبر SigV4 أو يرسل مفتاح Bedrock API، بينما يرسل على Google Cloud رمز وصول من Google يتم الحصول عليه عبر Application Default Credentials. لا يوجد سر صادر عن Anthropic في أي من الإعدادين، وتُحتسب الرسوم على حساب السحابة بدلاً من Anthropic. ولهذا أيضاً يُعد وجود مفتاح Anthropic في ANTHROPIC_API_KEY خطراً على تلك الخوادم: إذ سيرسل عميل عام موجّه إلى نقطة نهاية سحابية المفتاح إليها دون تردد.

هل يتوفر Claude على Azure؟

نعم، من خلال Microsoft Foundry، الذي كان يُعرف سابقاً باسم Azure AI Foundry. تنشئ مورداً في Foundry، وتنشر نموذج Claude فيه، ثم تستدعي https://{resource}.services.ai.azure.com/anthropic/v1/messages باستخدام مفتاح صادر عن Azure في ترويسة api-key أو رمز bearer مميز من Microsoft Entra. تُحتسب الرسوم عبر Azure Marketplace بوحدات Claude Consumption Units. يجب أن يحمل الحقل model في نص الطلب اسم النشر، ولا يطابق معرّف النموذج إلا إذا أبقيت الاسم الافتراضي عند إنشاء النشر؛ ولا يمكن تغيير الاسم بعد ذلك.

أين يجب أن أخزّن مفتاح Claude API على خادم Linux؟

في ملف يملكه root وبالوضع 600، ويُحمَّل عبر EnvironmentFile= في وحدة systemd. يقرأ systemd هذا الملف بصفته root قبل أن ينتقل إلى User= الخاص بالوحدة، ولذلك لا يحتاج حساب الخدمة إلى الوصول إليه. أبقِ المفتاح خارج المستودع، وخارج ملف الوحدة نفسه، الذي يمكن للجميع قراءته وتطبعه systemctl cat، وخارج إعدادات صورة الحاوية وطبقاتها وبيانات بنائها.

لماذا بدأت طلبات Claude API بإرجاع 401 رغم عدم تغيير أي شيء؟

يعيد المفتاح الذي يصل إلى تاريخ الانتهاء المحدد عند إنشائه الرمز 401. يُحدَّد تاريخ الانتهاء عند الإنشاء، ولا يمكن تعديله بعد ذلك، وتنتهي صلاحية المفاتيح قصيرة الأجل من دون رسالة تحذير بالبريد الإلكتروني. لا يمكن إعادة تفعيل المفتاح المنتهي، لذلك أنشئ بديلاً، واكتبه في ملف البيئة، وأعد تشغيل الخدمة، ثم ألغِ المفتاح القديم. إذا كان المفتاح سارياً بالتأكيد، فتحقق من عدم حجب بيانات اعتماد قديمة له: إذ إن تعيين ANTHROPIC_API_KEY إلى سلسلة فارغة يظل له أولوية على مصادر federation وprofile الموجودة أدناه.

هل كان هذا المقال مفيدًا؟

#claude#api#authentication#bedrock#vertex#secrets-management