---
read_when:
    - كتابة وثائق تتضمن رموزًا مميزة أو مفاتيح API أو مقتطفات من بيانات الاعتماد
    - تحديث الأمثلة التي قد تفحصها أدوات اكتشاف الأسرار
summary: اصطلاحات العناصر النائبة الآمنة لماسح الأسرار في الوثائق والأمثلة
title: اصطلاحات العناصر النائبة للأسرار
x-i18n:
    generated_at: "2026-07-12T06:32:34Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 0864f0fcc6fb1e4a3147b4b2ce0aac475437a19d694f3d059374782428c7f248
    source_path: reference/secret-placeholder-conventions.md
    workflow: 16
---

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

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

## الأسلوب الموصى به

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

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

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

## مثال

```bash
# جيد
export OPENAI_API_KEY="example-openai-key-not-real"

# أفضل (عندما تتناول الوثيقة ربط متغيرات البيئة)
export OPENAI_API_KEY="${OPENAI_API_KEY}"
```