Skip to content

Commit 2f8dd71

Browse files
committed
update index links
1 parent 9ce668f commit 2f8dd71

File tree

5 files changed

+47
-44
lines changed

5 files changed

+47
-44
lines changed

docs/access/index.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,20 +2,28 @@
22

33
This documentation guides users through the process of accessing CSCS systems and services.
44

5-
!!! info
5+
!!! note ""
66
Before accessing CSCS, you need to have an account at CSCS, and be part of a project that has been allocated resources.
77
More information on how to get an account is available in [accounts and projects][account-management].
88

9+
<div class="grid cards" markdown>
910

10-
There are different ways to authenticate your identity in order to access services at CSCS, using a password set by the user. Currently users can be authenticated with:
11+
- :fontawesome-solid-layer-group: __Multi Factor Authentification__
1112

12-
* Classic ssh with CSCS username/password, and also with ssh-keys
13-
* CSCS username/password on different web services. Sessions can be independent from each other so, signing into one service does not necessarily sign the user into another one
14-
* CSCS username/password on a Single Sign-On gate, which once the user is authenticated, can move between services (connected to this gate) without signing in again
15-
* Username/password from an external institution, provided that his/her CSCS account has been "linked" to that external identity beforehand and the service uses the Single Sign-On gate
13+
Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA)
1614

17-
## Single Sign-On
15+
[:octicons-arrow-right-24: MFA][mfa]
1816

19-
Most services at CSCS are connected to the CSCS Single Sign-On gate.
20-
This gives users the comfort of not having to sign in multiple times in each individual service connected to this gate and increases security.
21-
Furthermore, the Single Sign-On gate allow users to recover their forgotten passwords and authenticate using a third-party account. The login page looks like
17+
- :fontawesome-solid-layer-group: __Web Services__
18+
19+
Before signing in to CSCS' web portals or using SSH, all users have to set up multi factor authentification (MFA)
20+
21+
[:octicons-arrow-right-24: Accessing CSCS web services][access-web]
22+
23+
- :fontawesome-solid-layer-group: __SSH Access__
24+
25+
Logging into Clusters on Alps
26+
27+
[:octicons-arrow-right-24: SSH][access-ssh]
28+
29+
</div>

docs/access/ssh.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
[](){#ssh}
1+
[](){#access-ssh}
22
# Using SSH
33

44
Before accessing CSCS clusters using SSH, first ensure that you have [created a user account][account-management] that is part of a project that has access to the cluster, and have [multi factor authentification][mfa] configured.

docs/access/web.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
[](){#access-web}
12
# Accessing CSCS Web Portals
23

34
Most services at CSCS are connected to the CSCS Single Sign-On gate.

docs/alps/network.md

Lines changed: 0 additions & 11 deletions
This file was deleted.

docs/index.md

Lines changed: 27 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,30 @@
11
# CSCS Documentation
22

3-
Welcome to the techincal documentation for Alps.
3+
Start here to get access to CSCS services and Alps
4+
5+
<div class="grid cards" markdown>
6+
7+
- :fontawesome-solid-layer-group: __Accounts and Projects__
8+
9+
The first step is to get an account and a project
10+
11+
[:octicons-arrow-right-24: Accounts and Projects][account-management]
12+
13+
- :fontawesome-solid-key: __Logging In__
14+
15+
Once you have an account, you can set up multi factor authentification
16+
17+
[:octicons-arrow-right-24: Setting up MFA][mfa]
18+
19+
Then access CSCS services
20+
21+
[:octicons-arrow-right-24: Accessing CSCS Web Services][access-web]
22+
23+
[:octicons-arrow-right-24: Using SSH][access-ssh]
24+
25+
</div>
26+
27+
The Alps Research infrastructure hosts multiple platforms and clusters targeting different communities
428

529
<div class="grid cards" markdown>
630

@@ -16,7 +40,7 @@ Welcome to the techincal documentation for Alps.
1640

1741
[:octicons-arrow-right-24: Machine Learning Platform][mlp]
1842

19-
[:octicons-arrow-right-24: Climate and weather Platform][cwp]
43+
[:octicons-arrow-right-24: Climate and Weather Platform][cwp]
2044

2145
- :fontawesome-solid-mountain-sun: __Alps__
2246

@@ -28,27 +52,8 @@ Welcome to the techincal documentation for Alps.
2852

2953
[:octicons-arrow-right-24: Alps Hardware](alps/hardware.md)
3054

31-
[:octicons-arrow-right-24: Alps Network](alps/network.md)
32-
3355
[:octicons-arrow-right-24: Alps Storage](alps/storage.md)
3456

35-
36-
- :fontawesome-solid-key: __Getting Access__
37-
38-
A project is required to access resources on Alps
39-
40-
[:octicons-arrow-right-24: Applying for an Alps project](https://www.cscs.ch/user-lab/applying-for-accounts)
41-
42-
CSCS uses multifactor authentification for secure connection to our services and systems
43-
44-
[:octicons-arrow-right-24: Setting up MFA][mfa]
45-
46-
[:octicons-arrow-right-24: Logging into vClusters][ssh]
47-
48-
Manage your project and team in the user management portal
49-
50-
[:octicons-arrow-right-24: User management portal][ump]
51-
5257
</div>
5358

5459
## Get in Touch
@@ -71,7 +76,7 @@ If you can't find the information that you need in the documentation, help is av
7176

7277
</div>
7378

74-
# Tools and Services
79+
## Tools and Services
7580

7681
!!! todo
7782
Provide some links to the "how" documentation here.

0 commit comments

Comments
 (0)