اصطلاحات العناصر النائبة للأسرار

استخدم عناصر نائبة قابلة للقراءة البشرية لكنها لا تشبه الأسرار الحقيقية.

النمط الموصى به

• فضّل القيم الوصفية مثل example-openai-key-not-real أو example-discord-bot-token.
• في مقتطفات shell، فضّل ${OPENAI_API_KEY} على السلاسل المضمنة التي تشبه الرموز المميزة.
• اجعل الأمثلة مزيفة بوضوح ومحددة النطاق بحسب الغرض (المزوّد، القناة، نوع المصادقة).

تجنب هذه الأنماط في الوثائق

• نص ترويسة أو تذييل مفتاح خاص PEM حرفي.
• البادئات التي تشبه بيانات اعتماد حية، مثل sk-... وxoxb-... وAKIA....
• رموز bearer تبدو واقعية ومنسوخة من سجلات وقت التشغيل.

مثال

# Goodexport OPENAI_API_KEY="example-openai-key-not-real" # Better (when the doc is about env wiring)export OPENAI_API_KEY="${OPENAI_API_KEY}"