Difference between revisions of "Adobe Provisioning: Adding Config and Private Key"

From Studentnet Wiki
Jump to navigation Jump to search
Line 15: Line 15:
 
After successfully logging in to [https://www.adobe.com/go/devs_console_ui Adobe Developer Console], you arrive at the '''Home''' screen. This is where you can find quick start links to create a project or download resources, view and edit your public profile, and access the '''Projects''' and '''Downloads''' screens using the top navigation.
 
After successfully logging in to [https://www.adobe.com/go/devs_console_ui Adobe Developer Console], you arrive at the '''Home''' screen. This is where you can find quick start links to create a project or download resources, view and edit your public profile, and access the '''Projects''' and '''Downloads''' screens using the top navigation.
  
[[File:Adobe_Image_1.png|1100px|Adobe Setup 1]]
+
Click “create new project” to start
 +
 
 +
[[File:adobe_integration_1.png|1100px|Adobe Setup 1]]
  
 
===Step 2: Add an API to the project using Service Account (JWT)===
 
===Step 2: Add an API to the project using Service Account (JWT)===
The home screen provides "quick start" links to help you get started with some of the most common Console actions. Quick start links are available for: creating a new project, creating a project using a template, and downloading resources. Click “Create new project” to start
+
Click “Add API”
  
[[File:Adobe_Image_2.png|1100px|Adobe Setup 2]]
+
[[File:adobe_integration_2.png|1100px|Adobe Setup 2]]
  
  
Line 26: Line 28:
 
Scroll down to select User Management API and click Next
 
Scroll down to select User Management API and click Next
  
[[File:Adobe_Image_3.png|1100px|Adobe Setup 3]]
+
[[File:adobe_integration_3.png|1100px|Adobe Setup 3]]
  
 
===Step 4: Generate a key pair===
 
===Step 4: Generate a key pair===
 
Select OPTION 1 generate a key pair, click Next, and then save the '''downloaded config.zip '''(containing the public key and '''private key''') for future use
 
Select OPTION 1 generate a key pair, click Next, and then save the '''downloaded config.zip '''(containing the public key and '''private key''') for future use
  
[[File:Adobe_Image_4.png|1100px|Adobe Setup 4]]
+
[[File:adobe_integration_4.png|1100px|Adobe Setup 4]]
  
 
===Step 5: Save API===
 
===Step 5: Save API===
 
Click Save configured API
 
Click Save configured API
  
[[File:Adobe_Image_5.png|1100px|Adobe Setup 5]]
+
[[File:adobe_integration_5.png|1100px|Adobe Setup 5]]
  
 
Select User Management API from APIs on the sidebar
 
Select User Management API from APIs on the sidebar
  
[[File:Adobe_Image_6.png|1100px|Adobe Setup 6]]
+
[[File:adobe_integration_6.png|1100px|Adobe Setup 6]]
  
 
Click Retrieve client secret to get '''client secret'''
 
Click Retrieve client secret to get '''client secret'''
  
[[File:Adobe_Image_7.png|1100px|Adobe Setup 7]]
+
[[File:adobe_integration_7.png|1100px|Adobe Setup 7]]
  
 
Save '''client id''', '''client secret''', '''technical account id''', '''organization id''' for configuration
 
Save '''client id''', '''client secret''', '''technical account id''', '''organization id''' for configuration
  
[[File:Adobe_Image_8.png|1100px|Adobe Setup 8]]
+
[[File:adobe_integration_8.png|1100px|Adobe Setup 8]]
  
 
Open Cloudwork, click Adobe Coherent Cloud
 
Open Cloudwork, click Adobe Coherent Cloud
  
[[File:Adobe_Image_9.png|1100px|Adobe Setup 9]]
+
[[File:adobe_integration_9.png|1100px|Adobe Setup 9]]
  
 
Go to Adobe page
 
Go to Adobe page
  
[[File:Adobe_Image_10.png|1100px|Adobe Setup 10]]
+
[[File:adobe_integration_10.png|1100px|Adobe Setup 10]]
  
 
Click add new config details
 
Click add new config details
  
[[File:Adobe_Image_11.png|1100px|Adobe Setup 11]]
+
[[File:adobe_integration_11.png|1100px|Adobe Setup 11]]
  
Fill Org Id, Client Id, Client Secret, Tech Acct, and leave it for a while
+
Fill Org Id, Client Id, Client Secret, Tech Acct, and and input the school’s domain
  
===Step 6: Get the domain information for config===
+
You can see “New Config created
Log in to [https://adminconsole.adobe.com/ Adobe administrator console]
 
  
[[File:Adobe_Image_12.png|1100px|Adobe Setup 12]]
+
[[File:adobe_integration_12.png|1100px|Adobe Setup 12]]
  
[[File:Adobe_Image_13.png|1100px|Adobe Setup 13]]
+
The next step is to upload the private key
  
Click Settings
+
[[File:adobe_integration_13.png|1100px|Adobe Setup 13]]
  
[[File:Adobe_Image_14.png|1100px|Adobe Setup 14]]
+
Check the format of the private key, and click Choose file to upload the selected private key
  
Click Domains
+
[[File:adobe_integration_14.png|1100px|Adobe Setup 14]]
  
[[File:Adobe_Image_14.png|1100px|Adobe Setup 14]]
+
The uploaded file should end with '''.key'''
  
The domain is needed for the configuration to retrieve users from a domain linked to an organization through the Trusted Domain relationship, the domain will match the email domain. Copy a '''domain''' matching the school’s email domain.
+
[[File:adobe_integration_15.png|1100px|Adobe Setup 15]]
  
Go back to the form, and paste the domain. Submit.
+
And the file should exactly follow the format in the example
  
[[File:Adobe_Image_11.png|1100px|Adobe Setup 15]]
+
[[File:adobe_integration_16.png|1100px|Adobe Setup 16]]
  
You can see the flash “New Config Created”, and Private Key Uploaded is still no.
+
If the uploaded file is not compatible with input config details, you will be redirected to the Adobe page and seeing the red flashing message
  
[[File:Adobe_Image_16.png|1100px|Adobe Setup 16]]
+
[[File:adobe_integration_17.png|1100px|Adobe Setup 17]]
  
Head back to the '''Adobe''' page, you can see the updated config list.
+
If successful, you will be redirected to the Adobe page and see the green flashing
  
[[File:Adobe_Image_17.png|1100px|Adobe Setup 17]]
+
[[File:adobe_integration_18.png|1100px|Adobe Setup 18]]
  
The next step is to upload the private key
+
Click on the domain, you will see the private key uploaded has been changed to “yes”
 
 
Check the format of the private key, and click Choose file to upload the selected private key
 
  
[[File:Adobe_Image_18.png|1100px|Adobe Setup 18]]
+
[[File:adobe_integration_19.png|1100px|Adobe Setup 19]]
  
The uploaded file should end with '''.key'''
 
  
[[File:Adobe_Image_19.png|1100px|Adobe Setup 19]]
 
  
And the file should exactly follow the format in the example
 
  
[[File:Adobe_Image_20.png|1100px|Adobe Setup 20]]
 
  
If the uploaded file is not compatible with input config details, you will be redirected to the Adobe page and seeing the red flashing message
 
  
[[File:Adobe_Image_21.png|1100px|Adobe Setup 21]]
 
  
  
If successful, you will be redirected to the Adobe page and see the green flashing
 
  
[[File:Adobe_Image_22.png|1100px|Adobe Setup 22]]
 
  
Click on the domain, you will see the private key uploaded has been changed to “yes”
 
  
  
[[File:Adobe_Image_23.png|1100px|Adobe Setup 23]]
 
  
  
 
[[Category:Cloudwork Dashboard]]
 
[[Category:Cloudwork Dashboard]]

Revision as of 23:32, 8 March 2021

Adobe Configuration

You can either create a project on your own and provide us with the information listed in the following config file example or assign us a role to do so. If you want to create your own project, you can follow the procedure shown below:

Information needed for configuration:

  • Federated domain
  • Organization id
  • Client id
  • Client secret
  • Technical account id
  • Private key

The information can be obtained from the following steps

Step 1: Create a project in Adobe developer console

After successfully logging in to Adobe Developer Console, you arrive at the Home screen. This is where you can find quick start links to create a project or download resources, view and edit your public profile, and access the Projects and Downloads screens using the top navigation.

Click “create new project” to start

Adobe Setup 1

Step 2: Add an API to the project using Service Account (JWT)

Click “Add API”

Adobe Setup 2


Step 3: Create a User Management API

Scroll down to select User Management API and click Next

Adobe Setup 3

Step 4: Generate a key pair

Select OPTION 1 generate a key pair, click Next, and then save the downloaded config.zip (containing the public key and private key) for future use

Adobe Setup 4

Step 5: Save API

Click Save configured API

Adobe Setup 5

Select User Management API from APIs on the sidebar

Adobe Setup 6

Click Retrieve client secret to get client secret

Adobe Setup 7

Save client id, client secret, technical account id, organization id for configuration

Adobe Setup 8

Open Cloudwork, click Adobe Coherent Cloud

Adobe Setup 9

Go to Adobe page

Adobe Setup 10

Click add new config details

Adobe Setup 11

Fill Org Id, Client Id, Client Secret, Tech Acct, and and input the school’s domain

You can see “New Config created

Adobe Setup 12

The next step is to upload the private key

Adobe Setup 13

Check the format of the private key, and click Choose file to upload the selected private key

Adobe Setup 14

The uploaded file should end with .key

Adobe Setup 15

And the file should exactly follow the format in the example

Adobe Setup 16

If the uploaded file is not compatible with input config details, you will be redirected to the Adobe page and seeing the red flashing message

Adobe Setup 17

If successful, you will be redirected to the Adobe page and see the green flashing

Adobe Setup 18

Click on the domain, you will see the private key uploaded has been changed to “yes”

Adobe Setup 19