<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<style>
<!--
@font-face
        {font-family:Calibri}
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri","sans-serif"}
a:link, span.MsoHyperlink
        {color:blue;
        text-decoration:underline}
a:visited, span.MsoHyperlinkFollowed
        {color:purple;
        text-decoration:underline}
span.EmailStyle17
        {font-family:"Calibri","sans-serif";
        color:windowtext}
.MsoChpDefault
        {font-family:"Calibri","sans-serif"}
@page WordSection1
        {margin:1.0in 1.0in 1.0in 1.0in}
-->
</style><style type="text/css" id="owaParaStyle"></style>
</head>
<body lang="EN-US" link="blue" vlink="purple" fpstyle="1" ocsi="0">
<div style="direction: ltr;font-family: Tahoma;color: #000000;font-size: 10pt;">Thanks David. We'll address this in our docs meeting tomorrow and will get back to you if we have questions.
<div><br>
</div>
<div>-- Mike<br>
<div style="font-family: Times New Roman; color: #000000; font-size: 16px">
<hr tabindex="-1">
<div id="divRpF770189" style="direction: ltr;"><font face="Tahoma" size="2" color="#000000"><b>From:</b> Sullivan, David [David.Sullivan@windriver.com]<br>
<b>Sent:</b> Tuesday, June 25, 2019 10:15 AM<br>
<b>To:</b> starlingx-discuss@lists.starlingx.io; Tullis, Michael L<br>
<b>Subject:</b> [DOCS] Ability to add trusted CA certificate<br>
</font><br>
</div>
<div></div>
<div>
<div class="WordSection1">
<p class="MsoNormal">As part of this Launchpad there are changes that can impact documentation. Let me know if you require further details.</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">---</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Ability to add trusted CA</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">This change allows the administrator to install a trusted CA certificate to the system. A trusted CA certificate will be required if the end user configures a private docker registry that is signed by an unknown Certificate Authority. The
 provided certificate must be in PEM format.</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">There are two ways to add the trusted CA certificate.</p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">1) Using the CLI</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">system certificate-install -m ssl_ca <path_to_certificate></span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New""> </span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">This will install the certificate on all hosts. New configurations are applied to the hosts to install the certificates. 250.001 (Host Configuration is out-of-date) alarms are raised
 for those nodes and are cleared as the new configurations are applied.</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New""> </span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">Sample output:</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">system certificate-install -m ssl_ca domain.crt</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">WARNING: For security reasons, the original certificate,</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">containing the private key, will be removed,</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">once the private key is processed.</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">+-------------+--------------------------------------+</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">| Property    | Value                                |</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">+-------------+--------------------------------------+</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">| uuid        | c986249f-b304-4ab4-b88e-14f92e75269d |</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">| certtype    | ssl_ca                               |</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">| signature   | ssl_ca_14617336624230451058          |</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">| start_date  | 2019-05-22 18:24:41+00:00            |</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">| expiry_date | 2020-05-21 18:24:41+00:00            |</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">+-------------+--------------------------------------+</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New""> </span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">2) Using the ansible bootstrap playbook</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">A new optional variable is supported by the bootstrap playbook: ssl_ca_cert. The value of this variable is the full path to the certificate.
</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">eg</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">ssl_ca_cert: /path/to/ssl_ca_cert_file</span></p>
<p class="MsoNormal"><span style="font-size:10.0pt; font-family:"Courier New"">When this variable is provided the playbook will install the CA certificate. At this time installing the ssl_ca_cert is not supported during bootstrap replay.</span></p>
<p class="MsoNormal"> </p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Reviews:</p>
<p class="MsoNormal">https://review.opendev.org/#/c/663797/</p>
<p class="MsoNormal">https://review.opendev.org/#/c/665298/</p>
<p class="MsoNormal">https://review.opendev.org/#/c/665986/</p>
<p class="MsoNormal"> </p>
<p class="MsoNormal">Launchpad:</p>
<p class="MsoNormal">https://bugs.launchpad.net/starlingx/+bug/1831946</p>
</div>
</div>
</div>
</div>
</div>
</body>
</html>