<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>RDepot – Documentation</title>
    <link>/2.9.1/documentation/</link>
    <description>Recent content in Documentation on RDepot</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>en-us</language>
    
	  <atom:link href="/2.9.1/documentation/index.xml" rel="self" type="application/rss+xml" />
    
    
      
        
      
    
    
    <item>
      <title>Documentation: API</title>
      <link>/2.9.1/documentation/api/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/api/</guid>
      <description>
        
        
        &lt;p&gt;The API documentation is provided out-of-the-box by &lt;a href=&#34;https://github.com/swagger-api/swagger-ui&#34;&gt;swagger-ui&lt;/a&gt; and &lt;a href=&#34;https://springdoc.org/&#34;&gt;springdoc-openapi&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;One can configure this in the &lt;code&gt;application.yaml&lt;/code&gt; file of the RDepot backend application (rdepot-app).
By default it is configured as follows:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;springdoc&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;pathsToMatch&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/api/v2/**&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;api-docs&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;path&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/v2/api-docs&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;swagger-ui&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;path&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/docs/api.html&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;disable-swagger-default-url&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;true&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;url&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/v2/api-docs&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;display-query-params&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;true&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;default-produces-media-type&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;application/json&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;The Swagger UI web application can be found on any running RDepot instance, at the following URL: &lt;em&gt;http(s)://&amp;lt;rdepot-backend-public-url&amp;gt;/docs/api.html&lt;/em&gt; (see the &lt;code&gt;springdoc.swagger-ui.path&lt;/code&gt; configuration parameter above).&lt;/p&gt;
&lt;p&gt;The OpenAPI v3 specification in JSON can be found at the following URL: &lt;em&gt;http(s)://&amp;lt;rdepot-backend-public-url&amp;gt;/v2/api-docs&lt;/em&gt; (see the &lt;code&gt;springdoc.api-docs.path&lt;/code&gt; configuration parameter above).&lt;/p&gt;
&lt;p&gt;Please note that changing the &lt;code&gt;springdoc.swagger-ui.path&lt;/code&gt; and &lt;code&gt;springdoc.api-docs.path&lt;/code&gt; configuration parameters is not supported, as they are hard-coded in the web application security filter chain to be accessible without any authentication.&lt;/p&gt;
&lt;p&gt;One can disable the deployment of the Swagger UI web application by setting the &lt;code&gt;springdoc.api-docs.enabled&lt;/code&gt; configuration parameter to &lt;code&gt;false&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;See &lt;a href=&#34;https://springdoc.org/#properties&#34;&gt;here&lt;/a&gt; and &lt;a href=&#34;https://swagger.io/docs/open-source-tools/swagger-ui/usage/configuration/&#34;&gt;here&lt;/a&gt; for additional information on the configuration.&lt;/p&gt;
&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;h3 id=&#34;access-tokens&#34;&gt;Access tokens&lt;/h3&gt;
&lt;p&gt;As a user, one can create and manage access tokens in the RDepot web UI (section &amp;ldquo;Access tokens&amp;rdquo;, under &amp;ldquo;Settings&amp;rdquo;).
To create a new access token, click on the blue create button in the top right corner, give it a name and the number of days it should stay active.
After creation, the value of the access token will be shown only once so please copy this value and store it in a safe (i.e. encrypted) location.
The access token will have the same permissions as your own user.
If an access token has not expired but should not be used any longer, then the access token can be deleted by clicking the red delete button in the Actions column.&lt;/p&gt;
&lt;p&gt;The access token can be used in HTTP requests to the API by using &lt;a href=&#34;https://datatracker.ietf.org/doc/html/rfc7617#section-2&#34;&gt;HTTP basic authentication&lt;/a&gt; with your username as the user-id and your access token value as the password.&lt;/p&gt;
&lt;h3 id=&#34;oauth-20&#34;&gt;OAuth 2.0&lt;/h3&gt;
&lt;p&gt;If the RDepot API is &lt;a href=&#34;../administration/configuration/#oauth-20&#34;&gt;configured to use OAuth 2.0&lt;/a&gt;, then any access tokens from the configured provider should be accepted by the API.&lt;/p&gt;
&lt;h3 id=&#34;username-and-password&#34;&gt;Username and password&lt;/h3&gt;
&lt;p&gt;If the RDepot API is &lt;a href=&#34;../administration/configuration/#simple-authentication&#34;&gt;configured to use simple authentication&lt;/a&gt;, then the API does not directly allow username and password authentication for every request.
Instead, a short-lived access token (JWT) can be generated by executing the following HTTP POST request:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;curl &amp;#39;http(s)://&amp;lt;rdepot-backend-public-url&amp;gt;/login&amp;#39; \
  -X POST \
  -H &amp;#39;Accept: application/json&amp;#39; \
  -H &amp;#39;Content-Type: application/json&amp;#39; \
  --data-raw &amp;#39;{&amp;#34;login&amp;#34;:&amp;#34;your-username&amp;#34;,&amp;#34;password&amp;#34;:&amp;#34;your-password&amp;#34;}&amp;#39;
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;When executed successfully, the response will look like:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{&amp;#34;status&amp;#34;: &amp;#34;SUCCESS&amp;#34;,&amp;#34;code&amp;#34;: 200,&amp;#34;messageCode&amp;#34;: null,&amp;#34;message&amp;#34;: null,&amp;#34;data&amp;#34;: {&amp;#34;token&amp;#34;: &amp;#34;my-short-lived-access-token&amp;#34;}}
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;The returned short-lived access token can then be used as the bearer token in the &amp;ldquo;Authorization&amp;rdquo; request header (see &lt;a href=&#34;https://datatracker.ietf.org/doc/html/rfc6750#section-2.1&#34;&gt;RFC6750&lt;/a&gt;).&lt;/p&gt;
&lt;p&gt;An RDepot administrator can configure the lifetime of these tokens via the &lt;code&gt;api-token.lifetime&lt;/code&gt; property (5 minutes by default).&lt;/p&gt;
&lt;h2 id=&#34;searching-using-query-parameters&#34;&gt;Searching using query parameters&lt;/h2&gt;
&lt;p&gt;This section contains more information on the query parameters that can be used when using the API resources for searching.
Each section describes a different type of resource within RDepot and the specific query parameters that are useful in that case.&lt;/p&gt;
&lt;h3 id=&#34;packages&#34;&gt;Packages&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;deleted&lt;/td&gt;
&lt;td&gt;false&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;shows soft-deleted packages if true&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;maintainer&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;matches on maintainer&amp;rsquo;s name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;repository&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;matches on repository name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on package name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;submissionState&lt;/td&gt;
&lt;td&gt;ACCEPTED&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;technology&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;package-maintainers&#34;&gt;Package Maintainers&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;deleted&lt;/td&gt;
&lt;td&gt;false&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;shows soft-deleted package maintainers if true&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;repository&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;matches on repository name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on package name and maintainer&amp;rsquo;s name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;technology&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;repositories&#34;&gt;Repositories&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;deleted&lt;/td&gt;
&lt;td&gt;false&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;shows soft-deleted repositories if true&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;maintainer&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;matches on maintainer&amp;rsquo;s name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;name&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;published&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on repository name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;technology&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;repository-maintainers&#34;&gt;Repository Maintainers&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;deleted&lt;/td&gt;
&lt;td&gt;false&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;shows soft-deleted repository maintainers if true&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;resourceTechnology&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on repository name and maintainer&amp;rsquo;s name&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;users&#34;&gt;Users&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;active&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;deleted&lt;/td&gt;
&lt;td&gt;false&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;shows soft-deleted users if true&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;role&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on user&amp;rsquo;s email, login and name&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;submissions&#34;&gt;Submissions&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;fromDate&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;date&lt;/td&gt;
&lt;td&gt;ISO 8601 date string&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;repository&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;matches on repository name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on approver name, submitter name and package name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;state&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;options are ACCEPTED, WAITING, CANCELLED, REJECTED&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;technology&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;toDate&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;date&lt;/td&gt;
&lt;td&gt;ISO 8601 date string&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;newsfeed-events&#34;&gt;Newsfeed Events&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;eventType&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;fromDate&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;date&lt;/td&gt;
&lt;td&gt;ISO 8601 date string&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;packageName&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;packageVersion&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;repositoryName&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;resourceType&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;technology&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;toDate&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;date&lt;/td&gt;
&lt;td&gt;ISO 8601 date string&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;userName&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id=&#34;access-tokens-1&#34;&gt;Access Tokens&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;Query parameter&lt;/th&gt;
&lt;th&gt;Default&lt;/th&gt;
&lt;th&gt;Multiple&lt;/th&gt;
&lt;th&gt;Method&lt;/th&gt;
&lt;th&gt;Notes&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;active&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;expired&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;boolean&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;search&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;no&lt;/td&gt;
&lt;td&gt;contains&lt;/td&gt;
&lt;td&gt;matches on name&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;userLogin&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;td&gt;yes&lt;/td&gt;
&lt;td&gt;exact&lt;/td&gt;
&lt;td&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Azure and Microsoft Entra ID</title>
      <link>/2.9.1/documentation/administration/guides/azure/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/administration/guides/azure/</guid>
      <description>
        
        
        &lt;p&gt;RDepot can integrate with any OIDC provider, this example specifically demonstrates how to integrate RDepot with Azure and Microsoft Entra ID.&lt;/p&gt;
&lt;h2 id=&#34;configuring-azure&#34;&gt;Configuring Azure&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Log into the Azure Portal&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Go to the &lt;code&gt;App registrations&lt;/code&gt; service&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click on &lt;code&gt;New registration&lt;/code&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Fill in a name for the registration&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Choose &lt;code&gt;Accounts in this organizational directory only&lt;/code&gt;. Do not use the other options (not even for testing), unless you are aware of the implications.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;In the &lt;code&gt;Redirect URI&lt;/code&gt; section, choose &lt;code&gt;Single-page application (SPA)&lt;/code&gt; and use the following value (replacing &lt;code&gt;rdepot-demo.local&lt;/code&gt; with your domain name):&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://rdepot-demo.local/auth
&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;The filled in form should look like:&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;img/01-register.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click &lt;code&gt;Register&lt;/code&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Go to &lt;code&gt;Authentication&lt;/code&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Provide a front-channel logout URL&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://rdepot-demo.local/logout
&lt;/code&gt;&lt;/pre&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Check the &lt;code&gt;Access tokens&lt;/code&gt; box as the tokens to be issued by the authorization endpoint&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;img/02-auth.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click &lt;code&gt;Token configuration&lt;/code&gt; to configure optional claims&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click &lt;code&gt;Add optional claim&lt;/code&gt;, select &lt;code&gt;Access&lt;/code&gt; as token type, search for the &lt;code&gt;email&lt;/code&gt; and &lt;code&gt;preferred_username&lt;/code&gt; claims and check them both&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;img/03-claims.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Go back to the &lt;code&gt;Overview&lt;/code&gt; page and copy the &lt;code&gt;Application (client) ID&lt;/code&gt; and &lt;code&gt;Directory (tenant ID)&lt;/code&gt;. You will
need them in the RDepot web client configuration.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;img/04-info.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Click on &lt;code&gt;Endpoints&lt;/code&gt;, then open &lt;code&gt;OpenID Connect metadata document&lt;/code&gt; and copy the &lt;code&gt;jwks_uri&lt;/code&gt; value. You will need this in the RDepot manager app configuration.&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;configuring-the-rdepot-manager-app&#34;&gt;Configuring the RDepot manager app&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Using the previously fetched &lt;code&gt;jwks_uri&lt;/code&gt;, configure the &lt;code&gt;application.yaml&lt;/code&gt; as follows&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;oauth2&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;jwk-set-uri&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;{&lt;span style=&#34;color:#000&#34;&gt;jwks_uri}&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;login-field&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;preferred_username&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;app&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;authentication&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;oauth2&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;oauth2&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;default&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;admins&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;einstein@company.onmicrosoft.com&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Restart or redeploy the RDepot manager app&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;configuring-the-rdepot-web-client&#34;&gt;Configuring the RDepot web client&lt;/h2&gt;
&lt;p&gt;Now that you configured Azure and you retrieved all necessary parameters, you can configure the RDepot web client.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;Set the following environment variables (replacing the examples with the values you retrieved from the Azure portal):&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-sh&#34; data-lang=&#34;sh&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#000&#34;&gt;VITE_OIDC_AUTHORITY&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;https://login.microsoftonline.com/&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;{&lt;/span&gt;tenant-id&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;}&lt;/span&gt;/v2.0
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#000&#34;&gt;VITE_OIDC_REDIRECT_URI&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;https://rdepot.local/auth
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#000&#34;&gt;VITE_OIDC_CLIENT_ID&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;={&lt;/span&gt;your-client-id&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;}&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#000&#34;&gt;VITE_OIDC_POST_LOGOUT_REDIRECT_URI&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;https://rdepot.local/logout
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#000&#34;&gt;VITE_OIDC_RESPONSE_TYPE&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;code
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#000&#34;&gt;VITE_OIDC_SCOPE&lt;/span&gt;&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;=&lt;/span&gt;openid profile email &lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;{&lt;/span&gt;your-client-id&lt;span style=&#34;color:#ce5c00;font-weight:bold&#34;&gt;}&lt;/span&gt;/.default
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Restart or redeploy the RDepot web client&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;You should now be able to log in on RDepot using an Azure user. You can create additional users by going to the &lt;code&gt;Microsoft Entra ID / Users&lt;/code&gt; page in Azure.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Create a Repository</title>
      <link>/2.9.1/documentation/user-guide/create-repository/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/user-guide/create-repository/</guid>
      <description>
        
        
        &lt;p&gt;In order to create a new repository, go to &lt;strong&gt;Repositories&lt;/strong&gt; by clicking the corresponding entry in the left menu.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/repositories-wide.png&#34; alt=&#34;alt text&#34; title=&#34;Repository list&#34;&gt;&lt;/p&gt;
&lt;p&gt;Open the &lt;strong&gt;New repository&lt;/strong&gt; dialog by clicking the blue &lt;strong&gt;Create +&lt;/strong&gt; button in the top right corner of the page.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/create-repository.png&#34; alt=&#34;alt text&#34; title=&#34;New repository dialog&#34;&gt;&lt;/p&gt;
&lt;p&gt;Fill in the blanks correctly:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Name&lt;/strong&gt;: a unique identifier for this repository. Even when this repository is deleted, this name is still unique and cannot be reused by other repositories.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Publication URI&lt;/strong&gt;: the external facing URL that users will see. It will be used in UI pages that RDepot users see. In our local demo deployment, this tends to be &lt;code&gt;http://localhost/repo/&amp;lt;repository-name&amp;gt;&lt;/code&gt; (as the included web proxy will redirect &lt;code&gt;/repo/&lt;/code&gt; requests to the associated repository web server).&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Server address&lt;/strong&gt;: the (internal) URL that the RDepot manager uses when synchronizing changes to the repository. This should be set to the location of the RDepot Repo API. In our local demo deployment, this tends to be &lt;code&gt;http://oa-rdepot-repo:8080/&amp;lt;technology&amp;gt;/&amp;lt;repository-name&amp;gt;&lt;/code&gt; (&lt;code&gt;oa-rdepot-repo&lt;/code&gt; is the hostname of the RDepot Repo API Docker container in the demo &lt;code&gt;docker-compose.yaml&lt;/code&gt;). The icon button next to it will run a check to see whether the RDepot manager can reach the specified server address of the RDepot Repo API. Please make sure the RDepot manager can actually reach the specified server, as this will cause server issues during publishing if not configured correctly.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Technology&lt;/strong&gt;: one of the supported technologies, e.g. &lt;code&gt;R&lt;/code&gt; or &lt;code&gt;Python&lt;/code&gt;.&lt;/li&gt;
&lt;li&gt;(R only) &lt;strong&gt;Redirect to source&lt;/strong&gt;: when installing binary R packages, the repository web server will try to redirect missing binary R packages to the same (or newer) source R package within the same repository instead, before failing with a HTTP 404. This also may require additional configuration in the web proxy or web server, depending on your deployment. This additional configuration is already included in our local demo deployment.&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Requires authentication&lt;/strong&gt;: checking this will cause the RDepot UI to show the install command to use when a repository requires authentication. For R repositories, installing packages requires using &lt;a href=&#34;https://craneserver.net/docs/client/r/&#34;&gt;crane&lt;/a&gt; and for Python repositories, installing packages requires using &lt;a href=&#34;https://craneserver.net/docs/client/python/&#34;&gt;crane-pip&lt;/a&gt;.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Additional notes on the &lt;strong&gt;Publication URI&lt;/strong&gt;: the &lt;code&gt;/repo/&lt;/code&gt; part of the Publication URI depends on the deployment.
When hosting RDepot and the repository under the same domain, using a subpath will most likely be necessary (but another subpath can be used, as this is used to route traffic to the repository web server).
When hosting both RDepot and the repository on separate domains (for example, rdepot.example.com for RDepot and repos.example.com for the repository web server) it is not necessary to use a subpath, as routing can be done based on the (sub)domain.&lt;/p&gt;
&lt;p&gt;Additional notes on the &lt;strong&gt;Server address&lt;/strong&gt;: since RDepot v2.6.0 it is recommended to include the technology (r/python) as part of the URL. Not doing so will cause a deprecation warning to be shown in the UI. From RDepot v3.0, this will be mandatory.&lt;/p&gt;
&lt;p&gt;Then create the repository by clicking the corresponding blue &lt;strong&gt;submit&lt;/strong&gt; button.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/created-repository.png&#34; alt=&#34;alt text&#34; title=&#34;Repository created&#34;&gt;&lt;/p&gt;
&lt;p&gt;Your repository will be displayed as a new entry in the repositories table.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Mutual authentication using mTLS</title>
      <link>/2.9.1/documentation/administration/guides/mtls/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/administration/guides/mtls/</guid>
      <description>
        
        
        &lt;p&gt;In a production environment, we strongly suggest setting up secure communications between the manager and repository applications.
This can be done by using a server certificate for the repository application and configuring the manager application to trust the repository server certificate.
By default when using secure communications, there is only a one-way trust: the client (RDepot manager) trusts the server (RDepot repository).
However, security can be increased even more by configuring two-way trust: the server (RDepot repository) can be configured to trust the client (RDepot manager).
Usually, this is done using mutual authentication or mutual TLS (mTLS).&lt;/p&gt;
&lt;p&gt;In this guide, we will:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;create a custom certificate authority (CA)&lt;/li&gt;
&lt;li&gt;create a certificate signing request (CSR)
&lt;ul&gt;
&lt;li&gt;for the repository application&lt;/li&gt;
&lt;li&gt;for the manager application&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;create a signed certificate from the CSR using our custom CA from step 1
&lt;ul&gt;
&lt;li&gt;for the repository application&lt;/li&gt;
&lt;li&gt;for the manager application&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;configure the RDepot repository application
&lt;ul&gt;
&lt;li&gt;to use the certificate and private key&lt;/li&gt;
&lt;li&gt;to trust the RDepot manager certificate&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;configure the RDepot manager application
&lt;ul&gt;
&lt;li&gt;to use the certificate and private key&lt;/li&gt;
&lt;li&gt;to trust the RDepot repository certificate&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;create a new repository and test the connection between manager and repository&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;creating-a-custom-certificate-authority&#34;&gt;Creating a custom certificate authority&lt;/h2&gt;
&lt;p&gt;We can be our own certificate authority (CA) by creating a self-signed root CA certificate:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;# generate a self-signed root CA certificate:&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   output in X.509 certificate structure&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   use SHA-2 256 digest&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   valid for 10 years&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   use RSA with 2048 bits as the algorithm&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   save the private key to file ca.key&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   save the root CA certificate to file ca.crt&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;openssl req -x509 -sha256 -days &lt;span style=&#34;color:#0000cf;font-weight:bold&#34;&gt;3650&lt;/span&gt; -newkey rsa:2048 -keyout ca.key -out ca.crt
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;OpenSSL will prompt for a pass phrase to secure your private key and will request some additional (mostly optional) information.
Two files should have been created: &lt;code&gt;ca.key&lt;/code&gt; and &lt;code&gt;ca.crt&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&#34;creating-certificate-signing-requests&#34;&gt;Creating certificate signing requests&lt;/h2&gt;
&lt;p&gt;Before generating certificate signing requests (CSRs), we will need to generate private keys:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl genrsa -out repo.key 2048&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;The above command generates a new private key using the RSA algorithm with 2048 bits and stores it in the file &lt;code&gt;repo.key&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Now repeat this step for the manager application:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl genrsa -out backend.key 2048&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;In order to sign the certificates using the CA, we need CSRs.
A CSR includes the public key and some additional (mostly optional) information.
Generating CSRs uses the newly generated private keys (&lt;code&gt;repo.key&lt;/code&gt; and &lt;code&gt;backend.key&lt;/code&gt;) and can be done using the following commands:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl req -key repo.key -new -out repo.csr&lt;/code&gt; and &lt;code&gt;openssl req -key backend.key -new -out backend.csr&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;OpenSSL will prompt for some additional (mostly optional) information.
It is important however to specify the &lt;code&gt;Common Name (e.g. server FQDN or YOUR name)&lt;/code&gt; and make sure it matches the correct hostnames.
When using &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker-compose.yaml&#34;&gt;our Docker Compose deployment&lt;/a&gt;, the hostname of the repository server within the Docker RDepot network will be &lt;code&gt;oa-rdepot-repo&lt;/code&gt; and the hostname of the manager application will be &lt;code&gt;oa-rdepot-backend&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;Finally, the private keys should be readable by the application processes.
Executing &lt;code&gt;chown 2000:2000 repo.key &amp;amp;&amp;amp; chown 2000:2000 backend.key&lt;/code&gt; will change ownership of the private key files to the user and the group that are running the application processes.
You might need additional rights to change the ownership (using &lt;code&gt;sudo&lt;/code&gt; or something similar).
The group and user IDs (2000) are defined &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/rdepot-app/src/test/resources/docker/repo/Dockerfile#L6&#34;&gt;here&lt;/a&gt; and &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/rdepot-app/src/test/resources/docker/app/Dockerfile#L11&#34;&gt;here&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Four files should have been created: &lt;code&gt;repo.key&lt;/code&gt;, &lt;code&gt;repo.csr&lt;/code&gt;, &lt;code&gt;backend.key&lt;/code&gt; and &lt;code&gt;backend.csr&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&#34;creating-signed-certificates&#34;&gt;Creating signed certificates&lt;/h2&gt;
&lt;p&gt;Now that we have CSRs, we can finally sign our requests and generate the certificates.
Before doing so, it is recommended to create an additional configuration file for the SAN extension properties.
SAN allows you to configure and secure multiple IP addresses or domain names using the same certificate.&lt;/p&gt;
&lt;p&gt;Create a file called &lt;code&gt;san.ext&lt;/code&gt; with the following contents:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authorityKeyIdentifier = keyid:always,issuer:always
basicConstraints = CA:FALSE
subjectAltName = @alt_names
[alt_names]
DNS.1 = oa-rdepot-repo
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Feel free to include additional IP addresses or domain names by appending to the bottom of the above file (e.g. &lt;code&gt;DNS.2 = my-repo.com&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;Then, execute OpenSSL to generate our repository server certificate:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl x509 -req -CA ca.crt -CAkey ca.key -in repo.csr -out repo.crt -days 365 -CAcreateserial -extfile san.ext&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;Finally, execute OpenSSL to generate our manager application certificate:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl x509 -req -CA ca.crt -CAkey ca.key -in backend.csr -out backend.crt -days 365 -CAcreateserial&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;Two files should have been created: &lt;code&gt;repo.crt&lt;/code&gt; and &lt;code&gt;backend.crt&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&#34;configuring-the-rdepot-repository-application&#34;&gt;Configuring the RDepot repository application&lt;/h2&gt;
&lt;p&gt;This guide assumes you are using &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker-compose.yaml&#34;&gt;our Docker Compose demo deployment&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Map the previously generated certificates and private key as volumes in the &lt;code&gt;docker-compose.yaml&lt;/code&gt; file:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;services&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repo&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;volumes&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;repository:/opt/rdepot/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./docker/compose/repo/application.yaml:/opt/repo/application.yml:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./repo.crt:/opt/repo/server.crt:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./repo.key:/opt/repo/server.key:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./ca.crt:/opt/repo/ca.crt:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Then, edit &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker/compose/repo/application.yaml&#34;&gt;the application configuration file&lt;/a&gt; as follows:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;server&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;port&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#0000cf;font-weight:bold&#34;&gt;8443&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;enabled&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;true&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;bundle&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;repo-api&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;client-auth&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;NEED&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;spring&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;bundle&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;pem&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repo-api&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;options&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;protocol&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;TLS&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;enabled-protocols&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;TLSv1.3&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;keystore&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;certificate&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/repo/server.crt&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;private-key&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/repo/server.key&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;truststore&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;certificate&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/repo/ca.crt&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id=&#34;configuring-the-rdepot-manager-application&#34;&gt;Configuring the RDepot manager application&lt;/h2&gt;
&lt;p&gt;Map the previously generated certificates and private key as a volume in the &lt;code&gt;docker-compose.yaml&lt;/code&gt; file:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;services&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;backend&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;volumes&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;repositories:/opt/rdepot/repositories/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;snapshots:/opt/rdepot/generated/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;queue:/opt/rdepot/new/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./docker/compose/backend/application.yaml:/opt/rdepot/application.yml:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./backend.crt:/opt/rdepot/client.crt:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./backend.key:/opt/rdepot/client.key:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./ca.crt:/opt/rdepot/ca.crt:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Then, edit &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker/compose/backend/application.yaml&#34;&gt;the application configuration file&lt;/a&gt; as follows:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;spring&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;bundle&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;pem&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repo-api-client&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;keystore&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;certificate&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/rdepot/client.crt&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;private-key&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/rdepot/client.key&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;truststore&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;certificate&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/rdepot/ca.crt&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repository&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;api&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;enabled&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;true&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id=&#34;testing-the-new-setup&#34;&gt;Testing the new setup&lt;/h2&gt;
&lt;p&gt;After following all of the above, the deployment can finally be started by executing &lt;code&gt;docker-compose up&lt;/code&gt;.
In your browser, go to http://localhost and log in using the following credentials:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;username: &lt;code&gt;einstein&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;password: &lt;code&gt;testpassword&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Go to the repositories page at http://localhost/repositories and click on the blue + icon (top right) to create a new repository.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;./img/05-repositories.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;p&gt;In the &lt;code&gt;Server address&lt;/code&gt; field, enter &lt;code&gt;https://oa-rdepot-repo:8443/r/r-public&lt;/code&gt; and click on the test button to the left of the input field.
It should mention that the server address is correct.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;./img/06-server-address.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;h2 id=&#34;conclusion&#34;&gt;Conclusion&lt;/h2&gt;
&lt;p&gt;To conclude, in this guide we have setup mutual authentication using mTLS between the RDepot manager application and an RDepot repository application.
This was done using &lt;code&gt;openssl&lt;/code&gt; (for generating the necessary keys and certificates) and the provided Docker Compose demo deployment of RDepot.
Additionally, RDepot can be configured using only a couple of properties, both in the RDepot manager application properties and in the RDepot repository application properties.
A server key, server certificate and CA certificate were installed and configured on the repository server side and similarly on the manager client side.
Specifying the repository server address now should include &lt;code&gt;https&lt;/code&gt; instead of &lt;code&gt;http&lt;/code&gt; and port &lt;code&gt;8443&lt;/code&gt; instead of port &lt;code&gt;8080&lt;/code&gt; by default.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Publication Flow</title>
      <link>/2.9.1/documentation/administration/architecture/publication/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/administration/architecture/publication/</guid>
      <description>
        
        
        &lt;p&gt;The diagram below presents an in-depth overview of the synchronization flow between the RDepot Manager and Repo components.&lt;/p&gt;
&lt;hr&gt;
&lt;p&gt;&lt;img src=&#34;../publication-flow-chart.svg&#34; alt=&#34;Publication Flow&#34;&gt;&lt;/p&gt;
&lt;hr&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Roles</title>
      <link>/2.9.1/documentation/roles/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/roles/</guid>
      <description>
        
        
        &lt;p&gt;When mentioning viewing resources, this is only for the non-(soft-)deleted resources, unless mentioned otherwise.&lt;/p&gt;
&lt;h2 id=&#34;roles&#34;&gt;Roles:&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href=&#34;#guest-role&#34;&gt;Guest&lt;/a&gt; - unauthenticated user&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;#user-role&#34;&gt;User&lt;/a&gt; - the least privileged role in RDepot for authenticated users&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;#package-maintainer-role&#34;&gt;Package maintainer&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;#repository-maintainer-role&#34;&gt;Repository maintainer&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href=&#34;#admin-role&#34;&gt;Admin&lt;/a&gt; - the most privileged role in RDepot&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;guest-role&#34;&gt;Guest role&lt;/h2&gt;
&lt;p&gt;As a guest, I can:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;log in to the system [1.1]&lt;/li&gt;
&lt;li&gt;access the repo server [1.2]&lt;/li&gt;
&lt;li&gt;see published package details [1.3]&lt;/li&gt;
&lt;li&gt;install published packages in R [1.4]&lt;/li&gt;
&lt;li&gt;download published package sources [1.5]&lt;/li&gt;
&lt;li&gt;download published package vignettes [1.6]&lt;/li&gt;
&lt;li&gt;download published package reference manuals [1.7]&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;user-role&#34;&gt;User role&lt;/h2&gt;
&lt;p&gt;As a user, I can:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;access the repo server [2.1]&lt;/li&gt;
&lt;li&gt;log out from RDepot [2.2]&lt;/li&gt;
&lt;li&gt;see details about my account [2.3]&lt;/li&gt;
&lt;li&gt;submit packages [2.4]&lt;/li&gt;
&lt;li&gt;browse packages [2.5]&lt;/li&gt;
&lt;li&gt;browse all submissions [2.6]&lt;/li&gt;
&lt;li&gt;cancel my submissions if and only if they haven&amp;rsquo;t been approved [2.7]&lt;/li&gt;
&lt;li&gt;browse repositories [2.8]&lt;/li&gt;
&lt;li&gt;see packages in a given repository [2.9]&lt;/li&gt;
&lt;li&gt;see package details [2.10]&lt;/li&gt;
&lt;li&gt;install published packages in R [2.11]&lt;/li&gt;
&lt;li&gt;download published package sources [2.12]&lt;/li&gt;
&lt;li&gt;download published package vignettes [2.13]&lt;/li&gt;
&lt;li&gt;download published package reference manuals [2.14]&lt;/li&gt;
&lt;li&gt;browse package archives [2.15]&lt;/li&gt;
&lt;li&gt;create access tokens [2.16]&lt;/li&gt;
&lt;li&gt;manage my access tokens [2.17]&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;package-maintainer-role&#34;&gt;Package maintainer role&lt;/h2&gt;
&lt;p&gt;As a package maintainer, I can:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;do the same things as a user, and [3.1]&lt;/li&gt;
&lt;li&gt;submit packages with auto-approval of maintained packages [3.2]&lt;/li&gt;
&lt;li&gt;activate or deactivate maintained packages [3.3]&lt;/li&gt;
&lt;li&gt;delete maintained packages [3.4]&lt;/li&gt;
&lt;li&gt;approve or reject submissions of maintained packages [3.5]&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;repository-maintainer-role&#34;&gt;Repository maintainer role&lt;/h2&gt;
&lt;p&gt;As a repository maintainer, I can:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;do the same things as a package manager, and [4.1]&lt;/li&gt;
&lt;li&gt;submit packages with auto-approval in maintained repositories [4.2]&lt;/li&gt;
&lt;li&gt;publish/unpublish maintained repositories [4.3]&lt;/li&gt;
&lt;li&gt;update name, publication URI and server address of maintained repositories [4.4]&lt;/li&gt;
&lt;li&gt;approve/reject submissions in maintained repositories [4.5]&lt;/li&gt;
&lt;li&gt;synchronize maintained repositories which are mirrored [4.6]&lt;/li&gt;
&lt;li&gt;see synchronization status of maintained repositories which are mirrored [4.7]&lt;/li&gt;
&lt;li&gt;see the newsfeed [4.8]&lt;/li&gt;
&lt;li&gt;update the newsfeed [4.9]&lt;/li&gt;
&lt;li&gt;activate or deactivate packages in maintained repositories [4.10]&lt;/li&gt;
&lt;li&gt;delete packages in maintained repositories [4.11]&lt;/li&gt;
&lt;li&gt;browse package maintainers in maintained repositories [4.12]&lt;/li&gt;
&lt;li&gt;create package maintainer in maintained repositories [4.13]&lt;/li&gt;
&lt;li&gt;delete package maintainer in maintained repositories [4.14]&lt;/li&gt;
&lt;li&gt;update package maintainer in maintained repositories [4.15]&lt;/li&gt;
&lt;li&gt;see deleted package maintainers in maintained repositories [4.16]&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id=&#34;admin-role&#34;&gt;Admin role&lt;/h2&gt;
&lt;p&gt;As an admin, I can:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;do the same things as a repository maintainer (in any package or repository), and [5.1]&lt;/li&gt;
&lt;li&gt;submit packages to any repository with auto-approval [5.2]&lt;/li&gt;
&lt;li&gt;accept/reject any submission [5.4]&lt;/li&gt;
&lt;li&gt;see deleted submissions [5.5]&lt;/li&gt;
&lt;li&gt;permanently delete submissions (hard delete) [5.6]&lt;/li&gt;
&lt;li&gt;create repositories [5.7]&lt;/li&gt;
&lt;li&gt;see deleted repositories [5.8]&lt;/li&gt;
&lt;li&gt;permanently delete any repository (hard delete) [5.9]&lt;/li&gt;
&lt;li&gt;see deleted packages [5.10]&lt;/li&gt;
&lt;li&gt;permanently delete any package (hard delete) [5.11]&lt;/li&gt;
&lt;li&gt;browse all package maintainers [5.12]&lt;/li&gt;
&lt;li&gt;create package maintainers in any repository [5.14]&lt;/li&gt;
&lt;li&gt;modify any package maintainer [5.15]&lt;/li&gt;
&lt;li&gt;permanently delete any package maintainer (hard delete) [5.16]&lt;/li&gt;
&lt;li&gt;browse all repository maintainers [5.17]&lt;/li&gt;
&lt;li&gt;see deleted repository maintainers [5.18]&lt;/li&gt;
&lt;li&gt;create repository maintainers [5.19]&lt;/li&gt;
&lt;li&gt;delete any repository maintainers [5.20]&lt;/li&gt;
&lt;li&gt;update any repository maintainers [5.21]&lt;/li&gt;
&lt;li&gt;permanently delete any repository maintainer (hard delete) [5.22]&lt;/li&gt;
&lt;li&gt;browse all users [5.23]&lt;/li&gt;
&lt;li&gt;browse all roles [5.24]&lt;/li&gt;
&lt;li&gt;change the role of any user [5.25]&lt;/li&gt;
&lt;li&gt;activate or deactivate users [5.26]&lt;/li&gt;
&lt;li&gt;see users&amp;rsquo; access tokens [5.27]&lt;/li&gt;
&lt;li&gt;modify users&amp;rsquo; access tokens [5.28]&lt;/li&gt;
&lt;/ul&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Secure communications</title>
      <link>/2.9.1/documentation/administration/guides/secure-communications/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/administration/guides/secure-communications/</guid>
      <description>
        
        
        &lt;p&gt;In a production environment, we strongly suggest setting up secure communications between the manager and repository applications.
This can be done by using a server certificate for the repository application and configuring the manager application to trust the repository server certificate.&lt;/p&gt;
&lt;p&gt;In this guide, we will:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;create a custom certificate authority (CA)&lt;/li&gt;
&lt;li&gt;create a certificate signing request (CSR)&lt;/li&gt;
&lt;li&gt;create a signed certificate from the CSR using our custom CA from step 1&lt;/li&gt;
&lt;li&gt;configure the RDepot repository application to use the certificate and private key&lt;/li&gt;
&lt;li&gt;configure the RDepot manager application to use the CA certificate&lt;/li&gt;
&lt;li&gt;create a new repository and test the connection between manager and repository&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id=&#34;creating-a-custom-certificate-authority&#34;&gt;Creating a custom certificate authority&lt;/h2&gt;
&lt;p&gt;We can be our own certificate authority (CA) by creating a self-signed root CA certificate:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-shell&#34; data-lang=&#34;shell&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;# generate a self-signed root CA certificate:&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   output in X.509 certificate structure&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   use SHA-2 256 digest&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   valid for 10 years&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   use RSA with 2048 bits as the algorithm&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   save the private key to file ca.key&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#8f5902;font-style:italic&#34;&gt;#   save the root CA certificate to file ca.crt&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;openssl req -x509 -sha256 -days &lt;span style=&#34;color:#0000cf;font-weight:bold&#34;&gt;3650&lt;/span&gt; -newkey rsa:2048 -keyout ca.key -out ca.crt
&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;OpenSSL will prompt for a pass phrase to secure your private key and will request some additional (mostly optional) information.
Two files should have been created: &lt;code&gt;ca.key&lt;/code&gt; and &lt;code&gt;ca.crt&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&#34;creating-a-certificate-signing-request&#34;&gt;Creating a certificate signing request&lt;/h2&gt;
&lt;p&gt;Before generating a certificate signing request (CSR), we will need to generate a private key:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl genrsa -out repo.key 2048&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;The above command generates a new private key using the RSA algorithm with 2048 bits and stores it in the file &lt;code&gt;repo.key&lt;/code&gt;.&lt;/p&gt;
&lt;p&gt;In order to sign the server certificate using the CA, we need a CSR.
The CSR includes the public key and some additional (mostly optional) information.
Generating the CSR uses the newly generated private key (&lt;code&gt;repo.key&lt;/code&gt;) and can be done using the following command:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl req -key repo.key -new -out repo.csr&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;OpenSSL will prompt for some additional (mostly optional) information.
It is important however to specify the &lt;code&gt;Common Name (e.g. server FQDN or YOUR name)&lt;/code&gt; and make sure it matches the hostname of the repository API server.
When using &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker-compose.yaml&#34;&gt;our Docker Compose deployment&lt;/a&gt;, the hostname of the repository server within the Docker RDepot network will be &lt;code&gt;oa-rdepot-repo&lt;/code&gt;.
In this case, a value of &lt;code&gt;oa-rdepot-repo&lt;/code&gt; should be used as the &lt;code&gt;Common Name&lt;/code&gt; since this is what the RDepot manager application will use as the hostname when connecting to the repository API.&lt;/p&gt;
&lt;p&gt;Finally, the private key should be readable by the repository application process.
Executing &lt;code&gt;chown 2000:2000 repo.key&lt;/code&gt; will change ownership of the private key file to the user and the group that is running the repository application process.
You might need additional rights to change the ownership (using &lt;code&gt;sudo&lt;/code&gt; or something similar).
The group and user IDs (2000) are defined &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/rdepot-app/src/test/resources/docker/repo/Dockerfile#L6&#34;&gt;here&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Two files should have been created: &lt;code&gt;repo.key&lt;/code&gt; and &lt;code&gt;repo.csr&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&#34;creating-a-signed-certificate&#34;&gt;Creating a signed certificate&lt;/h2&gt;
&lt;p&gt;Now that we have a CSR, we can finally sign our request and generate the server certificate.
Before doing so, it is recommended to create an additional configuration file for the SAN extension properties.
SAN allows you to configure and secure multiple IP addresses or domain names using the same certificate.&lt;/p&gt;
&lt;p&gt;Create a file called &lt;code&gt;san.ext&lt;/code&gt; with the following contents:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;authorityKeyIdentifier = keyid:always,issuer:always
basicConstraints = CA:FALSE
subjectAltName = @alt_names
[alt_names]
DNS.1 = oa-rdepot-repo
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;Feel free to include additional IP addresses or domain names by appending to the bottom of the above file (e.g. &lt;code&gt;DNS.2 = my-repo.com&lt;/code&gt;).&lt;/p&gt;
&lt;p&gt;Then, execute OpenSSL to generate our repository server certificate:&lt;/p&gt;
&lt;p&gt;&lt;code&gt;openssl x509 -req -CA ca.crt -CAkey ca.key -in repo.csr -out repo.crt -days 365 -CAcreateserial -extfile san.ext&lt;/code&gt;&lt;/p&gt;
&lt;p&gt;One file should have been created: &lt;code&gt;repo.crt&lt;/code&gt;.&lt;/p&gt;
&lt;h2 id=&#34;configuring-the-rdepot-repository-application&#34;&gt;Configuring the RDepot repository application&lt;/h2&gt;
&lt;p&gt;This guide assumes you are using &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker-compose.yaml&#34;&gt;our Docker Compose demo deployment&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Map the previously generated server certificate and private key as volumes in the &lt;code&gt;docker-compose.yaml&lt;/code&gt; file:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;services&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repo&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;volumes&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;repository:/opt/rdepot/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./docker/compose/repo/application.yaml:/opt/repo/application.yml:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./repo.crt:/opt/repo/server.crt:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./repo.key:/opt/repo/server.key:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Then, edit &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker/compose/repo/application.yaml&#34;&gt;the application configuration file&lt;/a&gt; as follows:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;server&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;port&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#0000cf;font-weight:bold&#34;&gt;8443&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;enabled&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;true&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;bundle&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;repo-api&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;spring&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;bundle&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;pem&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repo-api&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;options&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;protocol&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;TLS&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;enabled-protocols&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;TLSv1.3&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;keystore&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;certificate&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/repo/server.crt&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;private-key&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#000&#34;&gt;/opt/repo/server.key&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id=&#34;configuring-the-rdepot-manager-application&#34;&gt;Configuring the RDepot manager application&lt;/h2&gt;
&lt;p&gt;Map the previously generated root CA certificate as a volume in the &lt;code&gt;docker-compose.yaml&lt;/code&gt; file:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;services&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;backend&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;volumes&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;repositories:/opt/rdepot/repositories/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;snapshots:/opt/rdepot/generated/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;queue:/opt/rdepot/new/&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./docker/compose/backend/application.yaml:/opt/rdepot/application.yml&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;- &lt;span style=&#34;color:#000&#34;&gt;./ca.crt:/opt/rdepot/ca.crt:ro&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;Then, edit &lt;a href=&#34;https://github.com/openanalytics/RDepot/blob/v2.9.1/demo/docker/compose/backend/application.yaml&#34;&gt;the application configuration file&lt;/a&gt; as follows:&lt;/p&gt;
&lt;div class=&#34;highlight&#34;&gt;&lt;pre tabindex=&#34;0&#34; style=&#34;background-color:#f8f8f8;-moz-tab-size:4;-o-tab-size:4;tab-size:4;&#34;&gt;&lt;code class=&#34;language-yaml&#34; data-lang=&#34;yaml&#34;&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;spring&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;bundle&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;pem&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;        &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repo-api-client&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;          &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;truststore&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;            &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;certificate&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#4e9a06&#34;&gt;&amp;#34;/opt/rdepot/ca.crt&amp;#34;&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;&lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;repository&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;  &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;api&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;    &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;ssl&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style=&#34;display:flex;&#34;&gt;&lt;span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;      &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;enabled&lt;/span&gt;&lt;span style=&#34;color:#000;font-weight:bold&#34;&gt;:&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt; &lt;/span&gt;&lt;span style=&#34;color:#204a87;font-weight:bold&#34;&gt;true&lt;/span&gt;&lt;span style=&#34;color:#f8f8f8;text-decoration:underline&#34;&gt;
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;h2 id=&#34;testing-the-new-setup&#34;&gt;Testing the new setup&lt;/h2&gt;
&lt;p&gt;After following all of the above, the deployment can finally be started by executing &lt;code&gt;docker-compose up&lt;/code&gt;.
In your browser, go to http://localhost and log in using the following credentials:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;username: &lt;code&gt;einstein&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;password: &lt;code&gt;testpassword&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Go to the repositories page at http://localhost/repositories and click on the blue + icon (top right) to create a new repository.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/05-repositories.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;p&gt;In the &lt;code&gt;Server address&lt;/code&gt; field, enter &lt;code&gt;https://oa-rdepot-repo:8443/r/r-public&lt;/code&gt; and click on the test button to the left of the input field.
It should mention that the server address is correct.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/06-server-address.png&#34; alt=&#34;&#34;&gt;&lt;/p&gt;
&lt;h2 id=&#34;conclusion&#34;&gt;Conclusion&lt;/h2&gt;
&lt;p&gt;To conclude, in this guide we have setup secure communications between the RDepot manager application and an RDepot repository application.
This was done using &lt;code&gt;openssl&lt;/code&gt; (for generating the necessary keys and certificates) and the provided Docker Compose demo deployment of RDepot.
Additionally, RDepot can be configured using only a couple of properties, both in the RDepot manager application properties and in the RDepot repository application properties.
A server key and certificate was installed and configured on the repository server side and a CA certificate was installed and configured to be trusted on the manager client side.
Specifying the repository server address now should include &lt;code&gt;https&lt;/code&gt; instead of &lt;code&gt;http&lt;/code&gt; and port &lt;code&gt;8443&lt;/code&gt; instead of port &lt;code&gt;8080&lt;/code&gt; by default.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Upload Packages</title>
      <link>/2.9.1/documentation/user-guide/upload-packages/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/user-guide/upload-packages/</guid>
      <description>
        
        
        &lt;p&gt;If you want to upload a new package, go to &lt;strong&gt;Upload packages&lt;/strong&gt; by clicking the entry in the left menu.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/upload-packages-wide.png&#34; alt=&#34;alt text&#34; title=&#34;Upload packages page&#34;&gt;&lt;/p&gt;
&lt;p&gt;Select the repository into which you want to upload packages by clicking on the dropdown menu in the middle of the page and selecting one from the list. Click continue to go to the next step.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/upload_python_packages.gif&#34; alt=&#34;alt text&#34; title=&#34;Uploading Python packages&#34;&gt;&lt;/p&gt;
&lt;p&gt;In the next step, add packages by clicking the gray box in the middle of the page or drag-and-drop files into the center of the screen.&lt;/p&gt;
&lt;p&gt;One can click on the &amp;ldquo;Replace&amp;rdquo; checkbox to the right of the package to replace packages in the repository with the same name and version. Replacing is unchecked by default.&lt;/p&gt;
&lt;p&gt;Starting from RDepot v2.5.0, notes can be added to any package upload. This can be used to specify release notes or other helpful information for maintainers (these are shown when reviewing submissions) and users (these are shown on the package details page) alike. Click the &amp;ldquo;Notes&amp;rdquo; checkbox to get started.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/add-notes-to-package-uploads.png&#34; alt=&#34;alt text&#34; title=&#34;Adding notes to package uploads&#34;&gt;&lt;/p&gt;
&lt;p&gt;Also new in RDepot v2.5.0: binary (Linux) packages for R. Click the &amp;ldquo;Binary file&amp;rdquo; checkbox and fill in the required fields: R version, architecture and (Linux) distribution. These values are configured on the server-side and can be modified by a server admin.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/binary-r-linux-packages.png&#34; alt=&#34;alt text&#34; title=&#34;Uploading binary R packages&#34;&gt;&lt;/p&gt;
&lt;p&gt;Additionally for R packages, there is also an option to generate a manual during the package upload process (see checkbox to the right of the package). Manual generation is checked by default. Manual generation is not supported for binary R packages.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/upload_r_packages.gif&#34; alt=&#34;alt text&#34; title=&#34;Uploading R packages&#34;&gt;&lt;/p&gt;
&lt;p&gt;If packages are uploaded successfully, there are green checkmarks to the left of the uploaded packages.
If there were any issues uploading the packages, red crosses are shown with the error message on hover.&lt;/p&gt;
&lt;p&gt;If you have the appropriate permissions (as an admin, a repository maintainer of the repository that you have uploaded the packages into or a package maintainer of the packages that you have uploaded), the package uploads or submissions were approved automatically.
If that is not the case, then the submissions need to be approved by the appropriate maintainer or admin first, before these package become available in the repository to be viewed and installed.&lt;/p&gt;
&lt;p&gt;After uploading a package, the system automatically chooses the maintainer for the package.
It does so using the following set of rules:&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;Is there any package maintainer for the package with that name and repository? If yes, the first returned package maintainer (by ID) will be chosen.&lt;/li&gt;
&lt;li&gt;Is there any repository maintainer for that repository? If yes, the first returned repository maintainer (by ID) will be chosen.&lt;/li&gt;
&lt;li&gt;The first returned admin (by ID) will be chosen.&lt;/li&gt;
&lt;/ol&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: Publish a Repository</title>
      <link>/2.9.1/documentation/user-guide/publish-repository/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/user-guide/publish-repository/</guid>
      <description>
        
        
        &lt;p&gt;To publish a repository, go to &lt;strong&gt;Repositories&lt;/strong&gt; and click on the &lt;strong&gt;Published&lt;/strong&gt; checkbox.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/publish-repository.gif&#34; alt=&#34;alt text&#34; title=&#34;Publish a repository&#34;&gt;&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: View and Review Submissions</title>
      <link>/2.9.1/documentation/user-guide/view-a-submission/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/user-guide/view-a-submission/</guid>
      <description>
        
        
        &lt;p&gt;To view and review submissions, go to &lt;strong&gt;Submissions&lt;/strong&gt;.
You can download any submitted packages by clicking the download icon in the actions column.&lt;/p&gt;
&lt;p&gt;As the uploader, if the submission is still in review, you can click the cancel icon in the actions column to cancel your submission.
As a maintainer or admin, a submission still in review can be either accepted or rejected by clicking on the appropriate icon in the actions column.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/submissions.png&#34; alt=&#34;alt text&#34; title=&#34;List of submissions&#34;&gt;&lt;/p&gt;
&lt;p&gt;If there are any notes added to a submission, the note icon in the actions column will be filled and the table row or note icon can be clicked to show the notes.&lt;/p&gt;

      </description>
    </item>
    
    <item>
      <title>Documentation: View and Install Packages</title>
      <link>/2.9.1/documentation/user-guide/view-packages/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/2.9.1/documentation/user-guide/view-packages/</guid>
      <description>
        
        
        &lt;p&gt;To see package details, go to &lt;strong&gt;Packages&lt;/strong&gt; and click on the package you are looking for.
You will see the long description of the package.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/packages-page.png&#34; alt=&#34;alt text&#34; title=&#34;List of packages&#34;&gt;&lt;/p&gt;
&lt;p&gt;In order to see the package details page simply click on the details button (blue arrow in the Actions column).&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/package-page.png&#34; alt=&#34;alt text&#34; title=&#34;R package details page&#34;&gt;&lt;/p&gt;
&lt;p&gt;You will be presented with the package details page, containing installation instructions, a download link and package details as well as the notes that were provided during the upload process.&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/package-page-notes.png&#34; alt=&#34;alt text&#34; title=&#34;R package details page with notes&#34;&gt;&lt;/p&gt;
&lt;p&gt;&lt;img src=&#34;../img/python_package.gif&#34; alt=&#34;alt text&#34; title=&#34;Python package details page&#34;&gt;&lt;/p&gt;

      </description>
    </item>
    
  </channel>
</rss>
