Update Web UI for SCC Manager & split modules by interface (#4404)

* Update WebUI to add SCC Account to Foreman+Katello
  This patch is required due to the redesign of the Web UI.
  Refs PR 165 in foreman_scc_manager
* Split adding SCC account modules by interface

Author: maximiliankolb

guides/common/assembly_managing-suse-content.adoc

@@ -8,7 +8,9 @@ include::modules/proc_creating-a-suse-operating-system.adoc[leveloffset=+1]
 
 include::modules/proc_installing-the-scc-manager.adoc[leveloffset=+1]
 
-include::modules/proc_adding-an-scc-account.adoc[leveloffset=+1]
+include::modules/proc_adding-an-scc-account-by-using-web-ui.adoc[leveloffset=+1]
+
+include::modules/proc_adding-an-scc-account-by-using-cli.adoc[leveloffset=+1]
 
 include::modules/proc_switching-scc-accounts.adoc[leveloffset=+1]
 

guides/common/modules/proc_adding-an-scc-account-by-using-cli.adoc

@@ -0,0 +1,51 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="adding-an-scc-account-to-{project-context}-by-using-cli"]
+= Adding an SCC account to {Project} by using Hammer CLI
+
+Add your SCC account to {Project} by using Hammer CLI.
+
+.Procedure
+. Optional: Import the public GPG key from SUSE into {Project}.
++
+For more information, see {ContentManagementDocURL}cli-importing-a-gpg-key[Importing a GPG Key] in _{ContentManagementDocTitle}_.
+. Add your SCC account to {Project}:
++
+[options="nowrap", subs="+quotes,verbatim,attributes"]
+----
+$ hammer scc_manager scc_accounts create \
+--base-url "https://scc.suse.com/" \
+--interval _My_Interval_ \
+--katello-gpg-key-id _My_GPG_Key_ID_ \
+--location-id _My_Location_ID_ \
+--login "_My_SCC_Account_Name_" \
+--name "_My_Account_Name_" \
+--organization-id _My_Organization_ID_ \
+--password "_My_SCC_Account_Password" \
+--sync-date _My_Sync_Date_
+----
+. Test your SCC account credentials:
++
+[options="nowrap", subs="+quotes,verbatim,attributes"]
+----
+$ hammer scc_manager scc_accounts test_connection \
+--id _My_SCC_Account_ID_
+----
++
+Ensure the command returns `Testing connection for SCC account succeeded`.
+. Synchronize the list of available SUSE products to {Project}:
++
+[options="nowrap", subs="+quotes,verbatim,attributes"]
+----
+$ hammer scc_manager scc_accounts sync \
+--id _My_SCC_Account_ID_
+----
+. Check the status of the task:
++
+[options="nowrap", subs="+quotes,verbatim,attributes"]
+----
+$ hammer task info \
+--id _My_Task_ID_
+----
++
+The synchronization is complete once the command returns `State: stopped` and `Result: success`.

guides/common/modules/proc_adding-an-scc-account-by-using-web-ui.adoc

@@ -0,0 +1,49 @@
+:_mod-docs-content-type: PROCEDURE
+
+[id="adding-an-scc-account-to-{project-context}-by-using-web-ui"]
+= Adding an SCC account to {Project} by using {ProjectWebUI}
+
+Add your SCC account to {Project}.
+
+[WARNING]
+====
+The SCC Manager plugin does not support multiple SCC accounts within one organization.
+Add an additional SCC account only if you want to switch to using another SCC account.
+
+If you need to use additional SCC accounts, add them to other organizations.
+====
+
+.Prerequisites
+* You have installed the SCC Manager plugin on your {Project}.
+For more information, see xref:Installing_the_SCC_Manager_plugin_{context}[].
+
+.Procedure
+. Optional: In the {ProjectWebUI}, navigate to *Content* > *Content Credentials* and click *Create Content Credential*.
++
+Add the GPG public key for SLES 15 SP3 from https://www.suse.com/support/security/keys/[suse.com].
+. In the {ProjectWebUI}, navigate to *Content* > *SUSE Subscriptions*.
+. Click *Add SCC account*.
+. In the *Name* field, enter a name for your SCC account in {Project}.
+. In the *Login* and *Password* fields, enter your SUSE credentials.
+. In the *Base URL* field, you can enter the base URL for the Suse Customer Center.
+By default, it is set to `\https://scc.suse.com`.
+. Click *Test connection* to verify your account information.
+. Optional: Set a *Refresh interval* to periodically update the SCC authentication token.
+Note that this does not refer to synchronizing content to {Project}.
+. Optional: Set a *Refresh time* to specify the time of the refresh of the SCC authentication token.
+. Optional: In the *GPG key for SUSE products* field, you can select the previously created content credential to automatically add a GPG public key to your SUSE products.
+`zypper` automatically verifies the signatures of each software package to ensure their authenticity.
++
+[NOTE]
+====
+You can also set the GPG public key for repositories from SUSE at a later stage.
+However, changing it does not affect already synchronized products.
+If you already have synchronized products in {Project}, navigate to *Content > Products* and replace the GPG key in each respective product.
+====
+. Optional: From the *Download Policy* list, select a download policy for your SUSE products.
+For more information, see xref:Download_Policies_Overview_{context}[].
+. Optional: From the *Mirroring Policy* list, select a mirroring policy for your SUSE products.
+For more information, see xref:Mirroring_Policies_Overview_{context}[].
+. Click *Submit* to save your SCC account to {Project}.
+. In the {ProjectWebUI}, navigate to *Content* > *SUSE Subscriptions*.
+. Select your SCC account and click *Sync* to fetch a list of products associated to your SCC account.

guides/common/modules/proc_adding-an-scc-account.adoc

@@ -8,7 +8,7 @@ To use the CLI instead of the {ProjectWebUI}, see the xref:cli-Importing_SUSE_Pr
 
 .Prerequisites
 * You have added your SCC account to {Project}.
-For more information, see xref:Adding_an_SCC_Account_to_Server_{context}[].
+For more information, see xref:adding-an-scc-account-to-{project-context}-by-using-web-ui[].
 
 .Procedure
 . In the {ProjectWebUI}, navigate to *Content > SUSE Subscriptions*.

guides/common/modules/proc_importing-suse-products.adoc

@@ -15,7 +15,7 @@ If you delete your old SCC account, you cannot reuse existing repositories, prod
 
 .Prerequisites
 * You have added your SCC account to {Project}.
-For more information, see xref:Adding_an_SCC_Account_to_Server_{context}[].
+For more information, see xref:adding-an-scc-account-to-{project-context}-by-using-web-ui[].
 
 .Procedure
 . In the {ProjectWebUI}, navigate to *Content > SUSE Subscriptions*.

guides/common/modules/proc_switching-scc-accounts.adoc

@@ -10,7 +10,7 @@ To use the CLI instead of the {ProjectWebUI}, see the xref:cli-Updating_an_SCC_A
 . In the {ProjectWebUI}, navigate to *Content* > *SUSE Subscriptions*.
 . Select your SCC account and update it as required.
 +
-For more information, see xref:Adding_an_SCC_Account_to_Server_{context}[].
+For more information, see xref:adding-an-scc-account-to-{project-context}-by-using-web-ui[].
 . Click *Submit* to update your SCC account.
 
 [id="cli-Updating_an_SCC_Account_{context}"]