Skip to Content

Wiki source code of DevOps Portal for Admins

Version 46.4 by Boris Folgmann on 2026/05/20 12:36
Hide last authors
giuseppecapaldot-systemscom 19.2 1 Welcome to the DevOps portal. This guide will guide you through the features that this portal role grants you so that you have a hassle-free experience.
giuseppecapaldot-systemscom 2.1 2
giuseppecapaldot-systemscom 20.1 3 (% class="box infomessage" %)
4 (((
giuseppecapaldot-systemscom 19.2 5 Upon receiving the **invitation email**, your initial action should be to **activate your account**
giuseppecapaldot-systemscom 19.1 6
Boris Folgmann 25.2 7 This process is the same as for regular users, and you can find detailed instructions by following the guide provided at this [[link>>doc:devopsaas:DevOps Portal for Users.WebHome||anchor="Invitation and activation"]].
giuseppecapaldot-systemscom 19.2 8
9 The same approach can be utilized for other functionalities, which I will list below:
10
Boris Folgmann 25.2 11 * [[Log in to DevOps Portal>>doc:devopsaas:DevOps Portal for Users.WebHome||anchor="Log in to DevOps Portal"]]
12 * [[Forgotten Password>>doc:devopsaas:DevOps Portal for Users.WebHome||anchor="Forgotten Password"]]
13 * [[Change password>>doc:devopsaas:DevOps Portal for Users.WebHome||anchor="Change password"]]
14 * [[Select Languages - Sprachen auswählen>>doc:devopsaas:DevOps Portal for Users.WebHome||anchor="Select Languages"]]
giuseppecapaldot-systemscom 19.2 15
giuseppecapaldot-systemscom 20.1 16 In addition of course you as admin have all the permissions of a creator:
giuseppecapaldot-systemscom 19.3 17
Boris Folgmann 46.4 18 * [[Creating Projects>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Creating Projects"]]
19 * [[Managing Projects>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Managing Projects"]]
20 * [[Assign a user to a project>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Assign a user to a project"]]
21 * [[Viewing and Modifying the role of a user in a project>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Viewing and Modifying the role of a user in a project"]]
22 * [[Creating user accounts>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Creating user accounts"]]
23 * [[Modifying user accounts>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Modifying user accounts"]]
24 * [[Creating Technical Users>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Creating Technical Users"]]
25 * [[Modifying Technical User accounts>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Modifying Technical User accounts"]]
26 * [[Creating Organizations>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Creating Organizations"]]
27 * [[Modify Organizations>>doc:devopsaas:DevOps Portal for Creators.WebHome||anchor="Modify Organizations"]]
giuseppecapaldot-systemscom 20.1 28 )))
giuseppecapaldot-systemscom 19.3 29
giuseppecapaldot-systemscom 19.2 30 Below, you will find a series of possible functions that your role as a admin grants within the portal:
31
giuseppecapaldot-systemscom 19.3 32 {{toc/}}
33
Ákos Pálvölgyi 26.2 34 = Managing Projects(% style="color:inherit; font-family:inherit; font-size:max(23px, min(29px, 12.3333px + 1.38889vw))" %){{id name="Managing Projects"/}}(%%) =
35
36 To see or update the settings of a project, click the **Project Key** (NEWPROJECT2 in the example). Click **More ...** to open the actions menu.
37
38 [[image:1753881036851-246.jpg||data-xwiki-image-style-border="true"]]
39
40 To modify a project you click the **Project Key** and check the box **Edit Details** at the bottom of the page. This will enable you to change the **Name**, the text in the **Description** field, the **Type** and the Jira **Notification Scheme** of your project. As well you are able to **add tools **to the project.
41
42 {{error title="⚠ **Warning**"}}
43 (% style="color:#993300" %)You can not remove tools from the project!
44
45 (% style="color:#993300" %)You can only add tools to the project!
46 {{/error}}
47
48 The action menu behind the **More...** button gives you additional control over the projects **YOU** created.
49 It enables you to do the following:
50
51 * Manage Users: Assign Users to the Project
52 * Manage Technical Users: Assign Technical Users for API access to the project
53 * Resync.: Since the DevOps Portal manages Projects accross all tools in the DevOps toolchain it now automatically links projects with the same Project Key in all tools which each other. To activate it for an existing project, simply Resync the Project.  ???
54
55 {{error title="⚠ **Warning**"}}
56 (% style="color:#993300" %)If you request a deletion from your ADMIN note that deleting a project is irreversible and all project data will be lost!
57 {{/error}}
58
Boris Folgmann 46.2 59 = =
Ákos Pálvölgyi 26.2 60
Ákos Pálvölgyi 29.2 61 = Assign a user to a project{{id name="Assign a user to a project"/}} =
62
63 If you would like to add a user to a project Click **Users** icon in the menu on the left side:
64
65 [[image:1757001036431-790.jpg||data-xwiki-image-style-border="true" height="249" width="188"]]
66
67 Then select the user from the list. To narrow down the results you can search for users:
68
69 [[image:1754051356874-344.jpg||data-xwiki-image-style-border="true" height="190" width="175"]]
70
71 {{warning}}
72 ⚠ **Note**
73 You are able to assign multiple users in one step to your project by selecting the check box infront of the names you want to assign with the same role.
74 {{/warning}}
75
76 Select the **Project** and the **New Role** - one of **ADMIN, MASTER, DEVELOPER, VIEWER** (depending on the desired rights). After that, click **Assign**:
77
78 [[image:1754052721855-651.jpg||data-xwiki-image-style-border="true"]]
79
80 Each user who is a member of a project has to be in //exactly one// Project Role. Therefore it is not possible to have multiple roles in a project. If you want to **Delete** a User from a project, simply select the **"-"** from the New Role dropdown menu.
81
82 Different roles have different sets of permissions. Possible roles are:
83
84 |=(((
85 Admin
86 )))|(((
87 Full access, even to potentially dangerous operations like Project Lifecycle Transitions. Can administer Project Members and Roles.
88 )))
89 |=(((
90 Master
91 )))|(((
92 Limited full access to avoid accidental data loss or other irreversible changes.
93 )))
94 |=(((
95 Developer
96 )))|(((
97 Read-write access to contribute to the Project
98 )))
99 |=(((
100 Viewer
101 )))|(((
102 Read-only access to all not security-relevant data in the Project
103 )))
104
105 Please refer to [[Users and roles>>doc:devopsaas:DevOps Portal for Admins.Users and roles.WebHome]] for a detailed description of users and roles in the tools.
106
107
Ákos Pálvölgyi 31.2 108 = Modifying user accounts =
109
110 A user account can be modified by clicking his / her last name. However, **it's not possible to change a user's e-mail address**.
111
112 [[image:1763562956443-820.png||data-xwiki-image-style-border="true" height="142" width="701"]]
113
114 To **change the user's email address**, the user must be **//deleted//** first. It can then be recreated with the new email address.
115
116 Under the Users menu, the **Lock/Unlock** function is available in the **More...** dropdown menu. This function is used to suspend a user account (which is a necessary step before deleting a profile). The status can be changed to locked or unlocked here.
117
118 Please keep in mind that a locked user can still receive notification emails.
119
120 [[image:1763563098133-556.png||data-xwiki-image-style-border="true" height="348" width="953"]]
121
122 In order to **delete** a user, he / she **must be locked first** and must remain in locked status for a certain period of time. Since deletion is not reversible, It is suggested to //only lock// users rather than deleting the user profile.
123
124 The **Delete** option will present a confirmation.
125
126 An attempt to delete a locked user without being in locked state long enough will result in an error message: "This user has not yet spent enough time in Locked status to be deleted."
127
128 In case of a re-invited user, it is also possible to let the admin do the activation process instead of the user. To do so, click **Activate**. The user can still change the password later with the reset password option. Please refer to the [[Forgotten Passwords>>doc:DevOps Portal for Users.WebHome||anchor="HForgottenPassword"]] section of the DevOps Portal for Users page for details regarding forgotten passwords.
129
130 {{warning}}
131 ⚠ **Note**
132 A user can have 3 statuses in the Self-service Portal: **CREATED**, **ACTIVE** and **LOCKED**. In case there is a //question mark// or an //exclamation mark// shown in brackets right after the status name, there might be some synchronization issue. For more information about user statuses and troubleshooting, please have a look at the [[User statuses in DevOps Portal>>doc:DevOps Portal for Admins.User statuses in DevOps Portal.WebHome]] page.
133 {{/warning}}
134
135
136 = Modifying Technical User accounts =
137
Ákos Pálvölgyi 37.2 138 [[image:image-2023-4-25_16-41-23.png||data-xwiki-image-style-border="true" width="1000"]]
Ákos Pálvölgyi 31.2 139
140 To view the details of a technical user, click its username. Tick the Edit Details box to make modifications to that user.
141
Ákos Pálvölgyi 37.2 142 [[image:image-2023-4-26_10-15-29.png||thumbnail="true" width="250"]]
Ákos Pálvölgyi 31.2 143
144 It's also possible to change the tech user's password here. There is a minimum length required for passwords.
145
146 [[image:1763563537660-474.png||data-xwiki-image-style-border="true" height="395" width="632"]]
147
148 If you would like to change the username or the selected tool you have to **Delete** the user and recreate it again. The **Delete** option will present a confirmation.
149
Ákos Pálvölgyi 37.2 150
151 = Modify Organizations =
152
153 To modify an organization's profile, click the** organization name** (Wayne Corp in the example).
154
155 [[image:1763563735395-115.png||data-xwiki-image-style-border="true" height="219" width="1000"]]
156
157 The **Edit an Organization page** will load and you can change the organization's name by replacing the name with the new one (so it is not necessary to delete an organization just because of the wrong name or a typo). As with the users edit page, the **Edit Details checkbox needs to be ticked **for editing to be enabled.
158
159 [[image:1763563793297-134.png||height="166" width="476"]]
160
161 There is an option to **Delete** an organization, but keep in mind, that deleting an organization is not reversible. An organization cannot be deleted if at least one user is still assigned to the organization. The deletion process can be accessed from the Actions - More button. A confirmation will appear.
162
163 [[image:1763563828637-290.png||data-xwiki-image-style-border="true" height="206" width="837"]]
164
165 The default organization is tied to the DevOps-as-a-Service instance and can never be renamed or deleted.
166
167
giuseppecapaldot-systemscom 19.2 168 = Administration menu of the DevOps Portal =
169
giuseppecapaldot-systemscom 19.1 170 In the Administration menu you can have special options to choose from, most of these features are for troubleshooting and monitoring.
171
Ákos Pálvölgyi 40.2 172 [[image:1763638275724-863.png||data-xwiki-image-style-border="true"]]
giuseppecapaldot-systemscom 19.1 173
Boris Folgmann 46.2 174 == ==
Ákos Pálvölgyi 40.2 175
giuseppecapaldot-systemscom 19.1 176 == Usage Terms ==
177
178 With the "Usage Terms" option you can create and upload your own terms and condition documents about the usage of your own DevOps-as-a-Service toolchain. It is basically an option to provide any document to accept by the users (e.g. documents related to data protection regulations).
179
180 As an administrator, you can upload a document by selecting this option and clicking **Create new Terms**.
181
Ákos Pálvölgyi 40.2 182 [[image:1763638312427-187.png||data-xwiki-image-style-border="true"]]
giuseppecapaldot-systemscom 19.1 183
184 Choose the preferred language, then click **Choose file**, browse the selected file from your local drive and click Open.
185
Ákos Pálvölgyi 40.3 186 [[image:1778589392712-973.png||height="221" width="576"]]
giuseppecapaldot-systemscom 19.1 187
188 The uploaded document is shown, you can check the content by clicking **Open**, remove the document by clicking **Delete**//,// or you can also **Cancel** the whole operation. If you would like to use the selected document, click **Save**.
189
Ákos Pálvölgyi 42.2 190 [[image:1778589684405-827.png]]
giuseppecapaldot-systemscom 19.1 191
192 The selected document will be listed in the documents table and you will be logged out - to re-login and to accept the uploaded document.
193
Ákos Pálvölgyi 42.2 194 [[image:1778589722037-175.png]]
giuseppecapaldot-systemscom 19.1 195
196 After uploading a new terms and conditions document, every existing user has to accept it. Otherwise they are not allowed to login to the DevOps portal.
197
198 When new users are invited to the portal, they will receive the uploaded file as an attachment in the invitation mail (so they will be able to read it before following the activation URL).
199
200 //Every user (including administrators) have to accept// the uploaded document only one time, however if you upload another document then both documents have to be accepted by the users.
201
202 To remove an uploaded document, click **Delete**. If you would like to check the content of the uploaded document, click **View**.
203
204 //If you decide not to upload a document at all (or you delete all the existing uploaded documents) the invitation process and the login of users will not depend on the acceptance of any document, since nothing is to be accepted.//
205
206 == Synchronization ==
207
208 All actions related to users or projects must be synchronized with the LDAP server prior to becoming effective. All pending (i.e. unfinished) synchronizations are listed at the **Pending synchronizations** page. Successful and finished synchronizations won't be listed.
209
210 This information is mainly provided for troubleshooting, in case of errors during the synchronization with the LDAP server.
211
Ákos Pálvölgyi 42.2 212 [[image:1763638748911-205.png]]
giuseppecapaldot-systemscom 19.1 213
214
215 == Licenses ==
216
217 The Licenses page provides information about the number of Active and Available Users as well as the package's User Limit.
218
Ákos Pálvölgyi 46.1 219 [[image:1763638850327-770.png||data-xwiki-image-style-border="true"]]
giuseppecapaldot-systemscom 19.1 220
Boris Folgmann 46.2 221 == ==
Ákos Pálvölgyi 46.1 222
giuseppecapaldot-systemscom 19.1 223 == Audits ==
224
225 Provides the audit log to check all past activities related to the Portal for up to 90 days.
226
Ákos Pálvölgyi 46.1 227 [[image:1763638883919-918.png||data-xwiki-image-style-border="true"]]
© 2018-2026 T-Systems International GmbH