كيفية إنشاء CSR على Tableau Server

يوضح لك هذا البرنامج التعليمي كيفية إنشاء CSR (طلب توقيع الشهادة) ومفتاح خاص لـ Tableau Server على كل من Windows وLinux. لا يحتوي Tableau Server على مُنشئ CSR مدمج، لذا تستخدم ملف OpenSSL التنفيذي المرفق ضمن حزمة Apache المضمنة. أنشئ المفتاح وطلب CSR على عقدة Tableau Server، وقدّم CSR إلى جهة إصدار الشهادات الخاصة بك، وبمجرد عودة الشهادة الموقعة، قم باستيرادها عبر Tableau Services Manager.

ما ستحتاجه

• صلاحية المسؤول (Windows) أو sudo (Linux) على عقدة Tableau Server.
• إصدار حزمة Apache الدقيق المرفق مع إصدار Tableau Server الخاص بك. اعرض محتويات C:Program FilesTableauTableau Serverpackages على Windows أو /opt/tableau/tableau_server/packages/ على Linux للعثور على المجلد المسمى apache.X.Y.Z. يتغير الجزء X.Y.Z مع كل إصدار من Tableau Server.
• اسم النطاق المؤهل بالكامل (FQDN) الذي سيخدمه Tableau Server بدقة، على سبيل المثال tableau.yourdomain.com، بالإضافة إلى أي أسماء مضيف إضافية تريد تغطيتها بنفس الشهادة (لحقل SAN).
• التفاصيل القانونية لمؤسستك (البلد، الولاية، المدينة، اسم المؤسسة) للاسم المميز (Distinguished Name) في CSR.

ملاحظة حول حجم المفتاح لعام 2026. يعمل Tableau Server 2025.3 وما بعده على OpenSSL 3.4.x بمستوى أمان 2، والذي يرفض مفاتيح RSA الأقصر من 2048 بت. استخدم RSA بحجم 2048 بت كحد أدنى؛ ويُعد 3072 أو 4096 بت ترقيةً معقولة للمفاتيح التي تخطط للاحتفاظ بها لعدة سنوات. حتى وثائق Tableau نفسها تستخدم RSA بحجم 4096 بت في مثالها.

إنشاء CSR على Tableau Server لنظام Windows

إذا كنت قد أنشأت CSR بالفعل، فانتقل إلى تقديم CSR إلى جهة إصدار الشهادات الخاصة بك ثم إلى تثبيت شهادة SSL على Tableau Server.

الخطوة 1: افتح موجّه أوامر بصلاحيات مرتفعة

اضغط على مفتاح Windows، واكتب cmd، ثم انقر بزر الماوس الأيمن فوق Command Prompt واختر Run as administrator. تُعد الصلاحيات المرتفعة ضرورية لأن OpenSSL المرفق موجود ضمن C:Program Files.

الخطوة 2: انتقل إلى دليل bin الخاص بـ Apache المرفق

يشحن Tableau إصدار OpenSSL الخاص به ضمن حزمة Apache. اعرض مجلد الحزم للتأكد من الإصدار الدقيق المثبت على خادمك:

dir "C:Program FilesTableauTableau Serverpackages"

سترى مجلدًا باسم apache.X.Y.Z (على سبيل المثال apache.20243.24.1015.1532). انتقل إلى دليل bin الخاص به، مع استبدال رمز الإصدار الخاص بك:

cd "C:Program FilesTableauTableau Serverpackagesapache.20243.24.1015.1532bin"

الخطوة 3: إنشاء المفتاح الخاص

أنشئ مفتاحًا خاصًا من نوع RSA بحجم 2048 بت. استبدل tableau بأي اسم ملف تفضله؛ سيشترك المفتاح وCSR في نفس الاسم الأساسي:

openssl.exe genrsa -out tableau.key 2048

حافظ على أمان tableau.key. هذا هو المفتاح الخاص الذي يقترن بالشهادة التي ستصدرها جهة إصدار الشهادات، ولا يمكن لـ Tableau Server تقديم TLS بدونه. يستخدم مثال وثائق Tableau 4096 بدلًا من 2048؛ وكلاهما مقبول لدى جهات إصدار الشهادات العامة.

الخطوة 4: إنشاء CSR مع امتداد SAN

تتحقق المتصفحات الحديثة وعملاء TLS من الشهادات مقابل امتداد Subject Alternative Name (SAN)، وليس مقابل الاسم الشائع (Common Name) وحده، لذا أدرج قائمة SAN في الطلب. استبدل أسماء المضيفين الواردة بعد DNS: بأسماء النطاق المؤهلة بالكامل التي يجب أن يستجيب لها Tableau Server:

openssl.exe req -new -key tableau.key -out tableau.csr -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

إذا اشتكى OpenSSL من عدم قدرته على تحميل ملف التهيئة (يمكن تجاهل تحذير بشأن /usr/local/ssl/openssl.cnf على Windows بأمان، لكن الخطأ الفادح يوقف الأمر)، فوجّهه صراحةً إلى ملف تهيئة OpenSSL المرفق مع Tableau عن طريق إضافة -config ..confopenssl.cnf:

openssl.exe req -new -key tableau.key -out tableau.csr -config ..confopenssl.cnf -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

الخطوة 5: أدخل تفاصيل مؤسستك

يطلب منك OpenSSL إدخال الحقول التي تدخل في الاسم المميز (Distinguished Name) لـ CSR. استخدم قيمًا دقيقة وقانونية: فجهات إصدار الشهادات العامة ترفض عدم التطابق مع السجلات التجارية.

• Country Name (2 letter code): رمز ISO المكوّن من حرفين لبلدك، على سبيل المثال US أو GB أو DE.
• State or Province Name: الاسم الكامل للولاية أو المقاطعة التي سُجلت فيها مؤسستك، على سبيل المثال California. لا تستخدم اختصارًا من حرفين.
• Locality Name: اسم المدينة الكامل، على سبيل المثال San Francisco.
• Organization Name: الاسم القانوني الكامل لشركتك، على سبيل المثال Your Company LLC. بالنسبة لشهادات التحقق من النطاق (DV)، لا يتم التحقق من هذا الحقل ويمكن تركه فارغًا، لكن لا تضغط على Enter فقط: فحينها سيُدرج OpenSSL أي قيمة افتراضية يحددها ملف التهيئة الخاص به، والتهيئة الافتراضية تأتي بقيمة Internet Widgits Pty Ltd، والتي ستنتهي في CSR الخاص بك. اكتب نقطة واحدة (.) لترك الحقل فارغًا فعليًا. وينطبق الأمر نفسه على حقلي Country وState، اللذين تكون قيمتاهما الافتراضية AU وSome-State.
• Organizational Unit Name: أصبح مهملًا ولم تعد جهات إصدار الشهادات العامة تصدره. اضغط Enter للتخطي.
• Common Name: اسم النطاق المؤهل بالكامل الذي سيكتبه المستخدمون للوصول إلى Tableau Server، على سبيل المثال tableau.yourdomain.com. أدرج نفس القيمة كأول إدخال في SAN.
• Email Address: بريد إلكتروني صالح للتواصل، أو اضغط Enter للتخطي.
• A challenge password وAn optional company name: اترك كلاهما فارغين. تتجاهل جهات إصدار الشهادات العامة هذين الحقلين.

عند انتهاء الطلبات، يكتب OpenSSL CSR إلى الملف tableau.csr في الدليل الحالي. تابع مع التحقق من CSR أدناه.

إنشاء CSR على Tableau Server لنظام Linux

الخطوة 1: العثور على دليل bin الخاص بـ Apache المرفق

يشحن Tableau Server على Linux إصدار OpenSSL الخاص به ضمن /opt/tableau/tableau_server/packages/apache.X.Y.Z/bin. اعرض مجلد الحزم للعثور على الإصدار الدقيق المثبت على خادمك:

ls /opt/tableau/tableau_server/packages/ | grep apache

سترى دليلًا باسم apache.X.Y.Z (على سبيل المثال apache.20243.24.1015.1532). استخدم هذا الاسم الدقيق في الأوامر أدناه. لست بحاجة إلى الانتقال (cd) إلى دليل bin؛ تستدعي الأمثلة إصدار OpenSSL المرفق بمساره المطلق حتى تتمكن من تشغيلها من دليلك الرئيسي.

الخطوة 2: إنشاء المفتاح الخاص

أنشئ مفتاحًا خاصًا من نوع RSA بحجم 2048 بت، مع استدعاء ملف OpenSSL التنفيذي المرفق بمساره المطلق. استبدل رمز الإصدار بالرمز الخاص بك:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl genrsa -out tableau.key 2048

حافظ على أمان tableau.key واجعله قابلًا للقراءة فقط من قبل المستخدم الذي سيقوم بتشغيل عملية الاستيراد. يستخدم مثال وثائق Tableau 4096 بدلًا من 2048؛ وكلاهما مقبول لدى جهات إصدار الشهادات العامة.

الخطوة 3: إنشاء CSR مع امتداد SAN

أدرج قائمة Subject Alternative Name مباشرةً في سطر الأوامر. استبدل أسماء المضيفين الواردة بعد DNS: بأسماء النطاق المؤهلة بالكامل التي يجب أن يستجيب لها Tableau Server:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl req -new -key tableau.key -out tableau.csr -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

إذا رفض OpenSSL البدء لعدم قدرته على تحميل التهيئة الافتراضية، فوجّهه إلى ملف تهيئة OpenSSL المرفق مع Tableau عن طريق إضافة العلامة -config:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl req -new -key tableau.key -out tableau.csr -config /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/conf/openssl.cnf -addext "subjectAltName=DNS:tableau.yourdomain.com,DNS:viz.yourdomain.com"

الخطوة 4: أدخل تفاصيل مؤسستك

يطلب منك OpenSSL إدخال نفس حقول الاسم المميز (Distinguished Name) كما في Windows. استخدم قيمًا دقيقة وقانونية:

• Country Name (2 letter code): رمز ISO المكوّن من حرفين، على سبيل المثال CA.
• State or Province Name: الاسم الكامل للولاية أو المقاطعة، على سبيل المثال Ontario.
• Locality Name: اسم المدينة الكامل، على سبيل المثال Ottawa.
• Organization Name: الاسم القانوني الكامل لشركتك، على سبيل المثال Your Company LLC. بالنسبة لشهادات التحقق من النطاق (DV)، لا يتم التحقق من هذا الحقل ويمكن تركه فارغًا، لكن لا تضغط على Enter فقط: فحينها سيُدرج OpenSSL أي قيمة افتراضية يحددها ملف التهيئة الخاص به، والتهيئة الافتراضية تأتي بقيمة Internet Widgits Pty Ltd، والتي ستنتهي في CSR الخاص بك. اكتب نقطة واحدة (.) لترك الحقل فارغًا فعليًا. وينطبق الأمر نفسه على حقلي Country وState، اللذين تكون قيمتاهما الافتراضية AU وSome-State.
• Organizational Unit Name: أصبح مهملًا. اضغط Enter للتخطي.
• Common Name: اسم النطاق المؤهل بالكامل الذي سيخدمه Tableau Server بدقة، على سبيل المثال tableau.yourdomain.com. أدرج نفس القيمة كأول إدخال في SAN.
• Email Address: بريد إلكتروني صالح للتواصل، أو اضغط Enter للتخطي.
• A challenge password وAn optional company name: اترك كلاهما فارغين.

يكتب OpenSSL CSR إلى الملف tableau.csr في الدليل الذي شغّلت منه الأمر.

تحقق من CSR قبل تقديمه

اكتشف الأخطاء المطبعية في الاسم المميز أو إدخالات SAN المفقودة قبل أن تتحقق منها جهة إصدار الشهادات. اطبع CSR باستخدام نفس إصدار OpenSSL المرفق. على Linux:

sudo /opt/tableau/tableau_server/packages/apache.20243.24.1015.1532/bin/openssl req -noout -text -in tableau.csr

على Windows، من نفس دليل bin الخاص بـ Apache:

openssl.exe req -noout -text -in tableau.csr

تأكد من ثلاثة أمور في الناتج: أن حقل Subject يعرض الاسم المميز الدقيق الخاص بك، وأن كتلة X509v3 Subject Alternative Name تسرد كل اسم مضيف تحتاجه، وأن حجم Public-Key يطابق ما قمت بإنشائه. يمكنك أيضًا لصق CSR في أداة فك تشفير CSR الخاصة بنا لإجراء نفس الفحص عبر المتصفح.

تقديم CSR إلى جهة إصدار الشهادات الخاصة بك

افتح tableau.csr في محرر نصوص. الملف عبارة عن نص عادي، يبدأ بـ -----BEGIN CERTIFICATE REQUEST----- وينتهي بـ -----END CERTIFICATE REQUEST-----. انسخ الكتلة بأكملها، بما في ذلك سطري الرأس والتذييل هذين، والصقها في حقل CSR أثناء إتمام الطلب لدى جهة إصدار الشهادات الخاصة بك.

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

تثبيت الشهادة الموقعة على Tableau Server

بمجرد أن تتحقق جهة إصدار الشهادات من طلبك وترسل إليك عبر البريد الإلكتروني الشهادة الموقعة بالإضافة إلى السلسلة (حزمة CA)، تقوم باستيراد الملفات الثلاثة (الشهادة، المفتاح الخاص، السلسلة) عبر Tableau Services Manager. يمكنك استخدام واجهة الويب الخاصة بـ TSM على العنوان https://<tsm-host>:8850 ضمن Configuration > Security > External SSL، أو سطر أوامر tsm، على سبيل المثال:

tsm security external-ssl enable --cert-file tableau.crt --key-file tableau.key --chain-file tableau-chain.crt
tsm pending-changes apply

انتبه لامتدادات الملفات. يتطلب Tableau أن ينتهي ملف السلسلة بـ .crt، وليس .pem أو .ca-bundle، ويجب أن يكون ملف الشهادة أيضًا بامتداد .crt. عادةً ما تقدم جهات إصدار الشهادات السلسلة كملف .ca-bundle، لذا أعد تسميته قبل الاستيراد، وإلا سيرفضه Tableau.

يعيد Tableau Server التشغيل لتحميل الشهادة الجديدة. للحصول على الإجراء الكامل (تنسيقات الملفات، التعامل مع عبارة المرور، التحقق بعد التثبيت)، راجع دليلنا كيفية تثبيت شهادة SSL على Tableau Server.

الأسئلة الشائعة