ויקי נטפרי - תרומות המשתמש [he]

התקנת תעודה ב-Docker

2022-11-03T20:34:54Z

ChayaS: הסבר על התקנת תעודת אבטחה בדוקר קיים

{{עמוד באנגלית|Installation of certificate in Docker}}
{{קישור לתצוגת קריאה}}
{{ניווט|תעודת האבטחה}}

Docker הינה תוכנה שמאפשרת לבנות סביבות הרצה עצמאיות על גבי מערכת הפעלה.

==שגיאות אבטחה ביישומים והרצות מתוך הקונטיינר==
קונטיינר של Docker מספק סביבה עצמאית - כמין מחשב חדש בפני עצמו.

כלים ותוכנות שפועלות בתוך הקונטיינר וניגשים לאינטרנט יתקלו בתעודה לא מוכרת של נטפרי, ולכן צריך להתקין את התעודה של נטפרי ברמת הקונטיינר.

===התקנת תעודת אבטחה בתמונות הנפוצות===

יש להוסיף את השורות הבאות לDockerfile, מתחת לשורת הFROM (במידה ואתם יודעים את טיב הפעולות תוכלו לשים אותו מאוחר ככל היותר לפני השלב הראשון בו נצרכת התעודה):

# --- NETFREE CERT INTSALL ---
ADD https://netfree.link/dl/unix-ca.sh /home/netfree-unix-ca.sh
RUN cat /home/netfree-unix-ca.sh | sh
ENV NODE_EXTRA_CA_CERTS=/etc/ca-bundle.crt
ENV REQUESTS_CA_BUNDLE=/etc/ca-bundle.crt
ENV SSL_CERT_FILE=/etc/ca-bundle.crt
# --- END NETFREE CERT INTSALL ---

התעודה נבדקה על תמונות מבוססות ubuntu,alpine,centos
וזה מגדיר גם משתני סביבה להפעלה תקינה של python ו nodejs

=== במקרה של קונטיינר קיים, ללא אפשרות לשנות את ה Dockerfile ===
יש להכנס לתוך הדוקר (פקודת docker exec, או דרך התוכנה docker-desktop) ולהריץ בתוכו את הפקודה:

curl <nowiki>https://netfree.link/dl/unix-ca.sh</nowiki> | sh

לאחר מכן לערוך את הקובץ ~/.bashrc ולהוסיף לו את הפקודות הבאות:

export NODE_EXTRA_CA_CERTS=/etc/ca-bundle.crt
export REQUESTS_CA_BUNDLE=/etc/ca-bundle.crt
export SSL_CERT_FILE=/etc/ca-bundle.crt

===במקרה של שימוש בdocker compose ללא Dockerfile===
ניתן לשלב את הוראות ההתקנה כפקודה יחידה, בתוך הקובץ docker-compose.yml, עבור הservice שבו יש צורך להתקין את תעודות האבטחה.
לצורך הדגמה:

#docker-compose.yml file example
version: "3.9"
services:
your-app:
image: node
command: sh -c "(curl -sL https://netfree.link/dl/unix-ca.sh | sh ) && export NODE_EXTRA_CA_CERTS=/etc/ca-bundle.crt && npm install && npm start"

===במקרה בעיה, ולהוראות מתאימות לתמונות אחרות===

כמובן שלכל תמונה ויישומים שבתוכה יש את הדרך שלה, במקרה שאתם מתקשים היעזרו במערכת הפניות (כללו תמיד בפניה את תוכן/קובץ הdockerfile במידת האפשר, ולפחות את שם תבנית התמונה, ולוג מלא ככל האפשר של השגיאה).

נסו גם להיעזר בפורומים טכניים.

===אפשרות נוספת===
https://github.com/AriFordsham/docker-cert

בפרוייקט הנ"ל יש סקריפט שאפשר להכניס במיקום כלשהו ב-PATH עם זכות קדימה לפקודת docker המקורית כך שהסקריפט יעטוף את פקודת docker המקורית. הסקריפט מייבא בצורה שקופה את התעודות של המערכת המארחת לתוך הקונטיינר בלי צורך לשנות את ה-DOCKERFILE. זה עובד במערכות לינוקס וווינדוס-WSL.

שאלות ובעיות בהפעלת הסקריפט ניתן לשאול כאן: https://forum.netfree.link/topic/9301

==שגיאות ברמת תוכנת הDocker עצמה==

תוכנת Docker עצמה משתמשת באינטרנט עבור הורדה של תמונה מהDocker hub או מקור אינטרנטי אחר,
בדרך כלל פעולה זו לא נתקלת בשגיאה של תעודת אבטחה כי התכונה מסתמכת על מאגר התעודות המותקן במחשב.

אם אתם נתקלים בשגיאה בשלב הזה (בד"כ בשורת FROM של קובץ Dockerfile או בפקודת docker pull או docker run), השגיאה נראית ככה:

Get https://registry-1.docker.io/v2/: x509: certificate signed by unknown authority

או

Error response from daemon: Get https://registry-1.docker.io/v2/: x509: certificate signed by unknown authority.

*ראשית ודאו שהתקנתם את התעודה של נטפרי במערכת שלכם (אם זה עתה התקנתם את התעודה, יש להפעיל מחדש את הDocker, הפעלת המחשב מחדש כמובן גם טובה).
*אם מדובר בהתקנה של Docker Toolbox, אז לא די בתעודה ברמת המערכת הפעלה כי מערכת זו עושה שימוש במערכת וירטואלית לפעולות של Docker עצמה.

במקרה זה הפעילו את הטרמינל של Docker והריצו בו את הפקודות הבאות:
docker-machine ssh default
curl -L <nowiki>http://api.internal.netfree.link/ca/netfree-ca.crt</nowiki> | sudo tee -a /etc/ssl/certs/ca-certificates.crt /var/lib/boot2docker/certs
sudo /etc/init.d/docker restart
exit
==שגיאות ברמת תוכנת Minikube==

תוכנת Minikube מספק מערכת להרצת kubernetes, ומפעיל סביבת Docker פנימי, אם אתם נתקלים בשגיאה של תעודת אבטחה או לחילופין התקנת חבילות שלו לא עבודת חלק.

במקרה זה הפעילו את הטרמינל של minikube והריצו בו את הפקודות הבאות:
minikube ssh
curl -sL <nowiki>http://netfree.link/dl/ubuntuCertInstallNetFree.sh</nowiki> | sudo -E bash -
sudo /etc/init.d/docker restart
exit

התקנת תעודה ב-Docker

2021-01-02T18:46:23Z

ChayaS: add neetfree pem to docker with ruby image

{{עמוד באנגלית|Installation of certificate in Docker}}
{{קישור לתצוגת קריאה}}
{{ניווט|תעודת האבטחה}}

Docker הינה תוכנה שמאפשרת לבנות סביבות הרצה עצמאיות על גבי מערכת הפעלה.

==שגיאות אבטחה ביישומים והרצות מתוך הקונטיינר==
קונטיינר של Docker מספק סביבה עצמאית - כמין מחשב חדש בפני עצמו.

כלים ותוכנות שפועלות בתוך הקונטיינר וניגשים לאינטרנט יתקלו בתעודה לא מוכרת של נטפרי, ולכן צריך להתקין את התעודה של נטפרי ברמת הקונטיינר, בהתאם לסוג התמונה.

רוב התמונות מבוססות linux, ולכן ההתקנה אמורה להיות בהם דומה.
ניתן להתקין בקונטיינר באותם דרכים שמריצים בו כל פקודה: או ע"י RUN בבניית התמונה, או ע"י exce מאוחר יותר.
להלן הוראות עבור Dockerfile למערכות מבוססות אובנטו וAlphin, למערכות אחרות יש לבדוק את המקבילות לכל פעולה.

===התקנת תעודת אבטחה בתמונה מבוססת אובנטו===

יש להוסיף את השורות הבאות לDockerfile, מתחת לשורת הFROM (במידה ואתם יודעים את טיב הפעולות תוכלו לשים אותו מאוחר ככל היותר לפני השלב הראשון בו נצרכת התעודה):

# --- NETFREE CERT INSALL---
RUN apt-get update -y
RUN apt-get install -y ca-certificates curl

ADD http://api.internal.netfree.link/ca/netfree-ca.crt /usr/local/share/ca-certificates/netfree-ca.crt

RUN update-ca-certificates

ENV NODE_EXTRA_CA_CERTS /etc/ssl/certs/ca-certificates.crt
# --- END NETFRE CERT INSALL ----

במקרה הזה הוגדר המשתנה סביבה NODE_EXTRA_CA_CERTS לפתור גם תעודת אבטחה ליישומים מבוססי נוד.

===התקנת תעודת אבטחה בתמונה מבוססת Alphin===

# --- NETFREE CERT INSALL---
RUN apk update && apk add ca-certificates && rm -rf /var/cache/apk/*

ADD http://api.internal.netfree.link/ca/netfree-ca.crt /usr/local/share/ca-certificates/netfree-ca.crt

RUN update-ca-certificates

ENV NODE_EXTRA_CA_CERTS /etc/ssl/certs/ca-certificates.crt
# --- END NETFRE CERT INSALL ----

===התקנת תעודת אבטחה ב image מבוסס Ruby (לדוג: ruby:2.4.1)===
ADD http://api.internal.netfree.link/ca/netfree-ca.crt /usr/local/share/ca-certificates/netfree-ca.crt

RUN chmod 644 /usr/local/share/ca-certificates/netfree-ca.crt && update-ca-certificates

===במקרה בעיה, ולהוראות מתאימות לתמונות אחרות===

כמובן שלכל תמונה ויישומים שבתוכה יש את הדרך שלה, במקרה שאתם מתקשים היעזרו במערכת הפניות (כללו תמיד בפניה את תוכן/קובץ הdockerfile במידת האפשר, ולפחות את שם תבנית התמונה, ולוג מלא ככל האפשר של השגיאה).

נסו גם להיעזר בפורומים טכניים.

==שגיאות ברמת תוכנת הDocker עצמה==

תוכנת Docker עצמה משתמשת באינטרנט עבור הורדה של תמונה מהDocker hub או מקור אינטרנטי אחר,
בדרך כלל פעולה זו לא נתקלת בשגיאה של תעודת אבטחה כי התכונה מסתמכת על מאגר התעודות המותקן במחשב.

אם אתם נתקלים בשגיאה בשלב הזה (בד"כ בשורת FROM של קובץ Dockerfile או בפקודת docker pull או docker run), השגיאה נראית ככה:

Get https://registry-1.docker.io/v2/: x509: certificate signed by unknown authority

או

Error response from daemon: Get https://registry-1.docker.io/v2/: x509: certificate signed by unknown authority.

*ראשית ודאו שהתקנתם את התעודה של נטפרי במערכת שלכם (אם זה עתה התקנתם את התעודה, יש להפעיל מחדש את הDocker, הפעלת המחשב מחדש כמובן גם טובה).
*אם מדובר בהתקנה של Docker Toolbox, אז לא די בתעודה ברמת המערכת הפעלה כי מערכת זו עושה שימוש במערכת וירטואלית לפעולות של Docker עצמה.

במקרה זה הפעילו את הטרמינל של Docker והריצו בו את הפקודות הבאות:
docker-machine ssh default
curl -L <nowiki>http://api.internal.netfree.link/ca/netfree-ca.crt</nowiki> | sudo tee -a /etc/ssl/certs/ca-certificates.crt /var/lib/boot2docker/certs
sudo /etc/init.d/docker restart
exit

התקנת תעודה ב-ruby

2020-09-13T11:22:32Z

ChayaS: /* למשמשתמשים עם RVM (Ruby Version Manager): */

{{עמוד באנגלית|Installation of certificate in ruby}}
{{קישור לתצוגת קריאה}}
{{ניווט|תעודת האבטחה}}

== הוראות התקנה ==
# הורידו את התעודה של הספק של נטפרי מהקישור הבא: http://netfree.link/netfree-ca.crt
# שנו את הסיומת של התעודה ל pem, עכשיו שם הקובץ יהיה: netfree-ca.pem
# הכניסו את התעודה לתיקייה המיועדת כפי שיפורט להלן.
# רעננו את התעודה כפי שיפורט להלן.

'''לתשומת לבך: בהתקנת גירסה שונה של Ruby, אם אינכם משתמשים ב RVM, יהיה צורך להתקין את התעודה בגירסה החדשה.'''

== התיקיה שבה יש להכניס את התעודה ==

ישנן שתי אפשרויות, נא [http://netfree.link/user#/tickets/new לדווח לנו למרכז הפניות] איזו אפשרות הועילה לכם, תודה.

=== בוינדוס: ===

<pre>C:\Ruby{מספר הגירסא}{-x64 - אם מדובר במערכת הפעלה של 64 סיביות}\ssl</pre>

לדוגמא: <pre>C:\Ruby25-x64\ssl</pre>

<pre>C:\Ruby{מספר הגירסא}{-x64 - אם מדובר במערכת הפעלה של 64 סיביות}\lib\ruby\{מספר הגירסא}\rubygems\ssl_certs\netfree.link</pre>

לדוגמא: <pre>C:\Ruby25-x64\lib\ruby\2.5.0\rubygems\ssl_certs\netfree.link</pre>

=== במאק: ===

<pre>/opt/rubies/{מספר הגירסא}/ssl</pre>

לדוגמא: <pre>/opt/rubies/2.5.0/ssl</pre>

<pre>/opt/rubies//lib/ruby/{מספר הגירסא}/rubygems/ssl_certs/netfree.link</pre>

לדוגמא: <pre>/opt/rubies/2.5.0/lib/ruby/2.5.0/rubygems/ssl_certs/netfree.link</pre>

=== למשמשתמשים עם RVM (Ruby Version Manager): ===

למציאת הנתיב שבו יש להכניס את התעודה: <pre>rvm osx-ssl-certs status all</pre>

לעדכון התעודות: <pre> rvm osx-ssl-certs update all </pre>

יתכן והפקודה ''update'' לא פעלה כמו שצריך, ניתן לבדוק האם תוכן הקובץ ''netfree-ca.pem'' הועתק לתוך הקובץ ''cert.pem''.

אם לא, אפשר להעתיק ידנית את הקובץ ''netfree-ca.pem''
לסוף הקובץ ''cert.pem'' הנמצא בניתוב הנ"ל.

(יש להעתיק כולל ''-----BEGIN CERTIFICATE-----'', ''-----END CERTIFICATE-----'')

== ריענון התעודות ==

=== בוינדוס: ===

בתיקיה הבאה מופיע הסקריפט c_rehash.r הפעילו אותו:

<pre>C:\Ruby{מספר הגירסא}{-x64 - אם מדובר במערכת הפעלה של 64 סיביות}\ssl\certs</pre>

=== במאק: ===

בתיקיה הבאה מופיע הסקריפט c_rehash.r הפעילו אותו:

<pre>/opt/rubies/{מספר הגירסא}/ssl/ssl_certs</pre>

=== למשמשתמשים עם RVM (Ruby Version Manager): ===
הריצו את הפקודה הבאה:
<pre> rvm osx-ssl-certs update all </pre>