Page History
Contents of this guide
With this guide you will learn how to create the internal Application Workbench account and how to connect it to the EPISODES Platform so that the Platform will be able to access the applications you created. We will also explain why this account has to be created as an addition to your EPISODES Platform account.
Why creating a new account is required?
The Application Workbench is a service which manages GIT repositories created for your custom application. While it supports authentication using the Single Sign-On (SSO) mechanisms of the EPISODES Platform, allowing you to log in with the Platform's credentials, it also allows you to manage and edit your code from outside of the Platform (see also Editing the application code). For this purpose, the Application Workbench requires creating an internal account with your chosen username (which might be different from the EPISODES Platform username). If you will be editing your application code only through the Web interface of the Application Workbench, you will not be required to log in with this account (logging in through the EPISODES Platform SSO will be sufficient). However, to create more advanced applications, editing the code outside of the Application Workbench (from your own computer) might be advisable, and for this purpose you will be able to use this internal account.
Creating the account
The account within the Application Workbench can be created only after authenticating through the EPISODES Platform authentication system (people who are not the EPISODES Platform users are not authorized to create an account). Therefore, the first thing you will have to do after entering the Application Workbech is logging in with this authentication system. To do this, first use the Login button at the right upper corner of the service (Figure 1).
Figure 1. Application Workbench main page with Login button marked.
This will present you with the Application Workbench account login page (Figure 2). As this is your first login, the credentials here are not yet configured, therefore, leave the form fields empty and use the Log in with EPISODES Platform button. Later, when you have your account configured, you can use the Username and Password fields to log in to the system as an alternative to the EPISODES Platform SSO when accessing the Application Workbench.
Figure 2. Application Workbench account login page
Upon this action, you will be redirected to EPISODES Platform authentication system, where you will be prompted for your EPISODES Platform user and password (see also this section in the Quick Start Guide) or automatically logged in, if your session with the EPISODES Platfrom is already active. After successful login, you will be able to create the Application Workbench account (Figure 3). Here, you will have to type
Registration
To create an account in the Application Workbench portal click the Sign in button in the right-upper corner of the portal (see Figure 1)
Figure 1. Sign in button placed within the Application Workbench portal
This will take you to Sign in screen (Figure 2). Click Sign in with EPISODES Platform to proceed
Figure 2. Sign In screen with Sign in with EPISODES Platform option marked
...
a username that you wish to have for
...
the Application Workbench account, and an email address that will be associated with
...
it. It is
...
recommended to
...
provide the same email address as the one used
...
for the EPISODES Platform
...
login. Note, that after this registration this screen will not be presented to you anymore, as the account will be already created.
...
Figure 3.
...
Application Workbench account registration page
After clicking Complete Account, you will be redirected
...
again to the Login page (Figure 2). Clicking
...
the Log in with EPISODES Platform
...
button again will now
...
you into your newly created account.
...
With subsequent logins, apart from the Log in with EPISODES Platform button you will be also able to use the username created in the previous step for the Application Workbench login, but to do that you will first have to
...
Connecting EPISODES Platform account with Application Workbench
Note |
---|
Note: this feature is still being worked on may be subject to change |
To be able to use applications from Application Workbench in the EPISODES Platform the platform needs to be given access to the Application Workbench account. To do this, you have to enter Gitea Access Token.
create a password for the account (this action is not required).
Anchor SettingPassword SettingPassword
Setting password for the Application Workbench account
SettingPassword | |
SettingPassword |
Setting a password to your Application Workbench account is not obligatory, as you always can login with your EPISODES Platform credentials. It is, however, required when modifying your applications directly from your computer using GIT commands or GUI, which is recommended for making more advanced modifications to your application files.
To set a password, go to the Settings page within the Application Workbench, which can be accessed from your profile menu (top right corner) as displayed in Figure 4.
Figure 4. Accessing the Settings page in Application Workbench
Once on the Settings page, navigate to the Account tab, choose the Forgot password? option (see Figure 5), and follow further instructions. Remember to provide the same e-mail address you used for the account registration (previous section).
Figure 5. Account tab of the Settings page with password setting option marked.
Connecting EPISODES Platform with Application Workbench account
Once the Application Workbench account is set, you are able to TODO, however, to use the applications within the EPISODES Platform or to use the Platform's wizard that helps with creating a new application, you have to connect the account you just created to the EPISODES Platform. The connection is realized by providing the Platform with a user token generated for your account. In this way, we do not store any sensitive data (username and password) from your Application Workbench account. Yet, we are able to connect to the Application Workbench on your behalf. You can also use the token mechanism when editing application files on your computer, however, we recommend to use a different token (you can generate any number of them) for other purposes than connection with the EPISODES Platform.
Note, that, unlike previous steps, this starts with entering the EPISODES Platform.
To connect the account, go to the Profile and affiliations page and use the Connect to Application Workbench button (Figure 6).
TODO: nowe screen-shoty z profilu w Platformie (po ISL-4200)
Figure 6. Profile and affiliations page with Connect to Application Workbench button
This will display a form enabling for either pasting a generated user token or for automatic generation of the token (Figure 7). To manually create a user token, follow the instructions in the Manual generation of user token section. This option is especially recommended if TODO. For automatic generation of the token, just providing your user and password for the Application Workbench account is required (the credentials are not stored by the Platform, they are used only for the process of generating the token for you. Note, that, to use this option, you will have to first set up the password for the Application Workbench account.
TODO: nowe screen-shoty z profilu w Platformie (po ISL-4200)
Figure 7. Profile and affiliations page with token input and genaration options
Anchor | ||||
---|---|---|---|---|
|
TODO Go to Gitea Profile and Settings and click Settings:
...
Figure
...
8.
...
Accessing the Settings page in Application Workbench
Then go to Applications tab type Token Name (it can be any name eg. "EPISODES Platform") and click Generate Token:
Figure 5. Generate token
As a result you will see your unique Access Token. Copy it now as it wil not be shown again.
Figure 6. Copy token
Now go to EPISODFES Platform and use the button "Connect to Application Workbench" in your profile settings ("Profile and affiliations" panel). Paste the Access Token you generated in the previous step in the input that will appear after clicking the button and confirm.
Note: the option is currently available only to the users with role 'TESTER'
Figure 7. Profile and affiliations screen with "Connect to Application Workbench" button
Figure 8. Paste token and save.
Figure 9. Saved token
You can revoke the generated token at any time, however, bear in mind that in such case the connection between your Application Workbench account and EPISODES Platform account will be lost. Generating a new token and configuring it instead of the revoked one will restore this connection.
TODO:
Dodać informację że bez loginu jest czasem 404
Related Documents
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...