Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added assets/images/ISO/011-disk_selection.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -76,8 +76,12 @@ The installation interface will be in text mode and will only ask for confirmati

![validation_script](/images/ISO/01-validation_script.png)

After that, a little menu showing all the available, non-removable disks, will be shown in the format `disk|sizeGB`. After choosing the disk, a confirmation menu with the options `yes` and `no` will be shown.

![disk_selection](/images/ISO/011-disk_selection.png)

{{< alert title="Warning: data will be deleted" color="warning" >}}
**IMPORTANT: OpenNebula will be installed on the first disk found and it will delete IRREVERSIBLY all the data in that disk. Ensure that this is the right server.**{{< /alert >}}
**IMPORTANT: OpenNebula will be installed on the selected disk and it will delete IRREVERSIBLY all the data in that disk. Ensure that this is the right disk and server.**{{< /alert >}}

After the confirmation, the installation will start. It will show some information related to the default settings and the packages that will be installed

Expand Down Expand Up @@ -279,34 +283,22 @@ After the installation, the server runs only the frontend and needs to be added
When a node is added, always use it's external IP, neither `localhost` nor a loopback addres `127.x.x.x'.
{{< /alert >}}

After selecting the option `add_host`, the IP for the host will be asked for.
In this case we are using the IP that was configured before, 172.20.0.7
After selecting the option `add_host`, the IP for the host and the user to log into it will be asked for.
- In this case we are using the IP that was configured before, 172.20.0.7
- The user to log into the node MUST be root or have sudo root access without password

```
┌──────────────────────────────────────────────────────────┐
│ Insert the IP for the node │
│ ┌──────────────────────────────────────────────────────┐ │
│ │172.20.0.7 │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
├──────────────────────────────────────────────────────────┤
│ < OK > <Cancel> │
└──────────────────────────────────────────────────────────┘

```
┌────────────────────────────────Add Node──────────────────────────────────┐
│ ┌──────────────────────────────────────────────────────────────────────┐ │
│ │Host IP: │ │
│ │User (with root permissions): │ │
│ └──────────────────────────────────────────────────────────────────────┘ │
│ │
├──────────────────────────────────────────────────────────────────────────┤
│ < OK > <Cancel> │
└──────────────────────────────────────────────────────────────────────────┘

Then, the user to log into the node will be asked. It MUST be root or have sudo root access without password

```
┌──────────────────────────────────────────────────────────┐
│ Insert the user for the node │
│ ┌──────────────────────────────────────────────────────┐ │
│ │root │ │
│ └──────────────────────────────────────────────────────┘ │
│ │
├──────────────────────────────────────────────────────────┤
│ < OK > <Cancel> │
└──────────────────────────────────────────────────────────┘
```

A confirmation dialog like the following will be shown:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ All other IdP-specific configuration settings for the driver should be set up th

### Microsoft Entra ID

Microsoft Entra ID SAML is compatible with OpenNebulaa but has some peculiarities:
Microsoft Entra ID SAML is compatible with OpenNebula SAML authentication but has some peculiarities:

- An enterprise application must be created in order to work. The application has a login URL that is the one that must be set up in FireEdge.
- Groups are equivalent to roles. The free tiers of Entra do not allow the creation of roles, but groups can be retrieved with the same claim
Expand All @@ -228,7 +228,9 @@ Microsoft Entra ID SAML is compatible with OpenNebulaa but has some peculiaritie

#### Creating the OpenNebula Entra ID application

OpenNebula Service provider name `:sp_entity_id` and the Assertion consumer service URL `:acs_url` must be set up. The following base configuration will be used as example (these must be defined on the file `/etc/one/auth/saml_auth.conf`)
OpenNebula Service provider name `:sp_entity_id` and the Assertion consumer service URL `:acs_url` must be set up. The following base configuration will be used as example (these must be defined on the file `/etc/one/auth/saml_auth.conf`).

In this case, our FireEdge server is available on `https://onelocal:8443/fireedge`. Please, modify the URL accordingly to `http(s)://<FIREEDGE_SERVER>:<FIREEDGE_PORT>/fireedge/api/auth/acs`.

```
:sp_entity_id: 'onelocal'
Expand Down Expand Up @@ -269,11 +271,13 @@ New Application

![entra_10_modify_NameID](/images/auth/entra/entra_10_modify_NameID.png)

- As commented previously, the default additional claims can be deleted (pressing the ... close to the name).

As commented previously, the default additional claims can be deleted (pressing the ... close to the name).


![entra_09_delete_claims](/images/auth/entra/entra_09_delete_claims.png)

- To do OpenNebula group mapping, a group claim must be created, pressing "Add a group claim" and setting one of the group options, normally "Security groups". The changes must be saved.
To do OpenNebula group mapping, a group claim must be created, pressing "Add a group claim" and setting one of the group options, normally "Security groups". The changes must be saved.

![entra_11_add_group_claim](/images/auth/entra/entra_11_add_group_claim.png)

Expand All @@ -282,7 +286,8 @@ This claim will provide Entra ID groups and roles, because they are treated as i

- On the __SAML Certificates__ section, the **Federation Metadata XML** file must be downloaded to extract the idp certificate (the parameter `:idp_cert` of the OpenNebula configuration file). The certificate is the value of the field `/EntityDescriptor/Signature/ds:KeyInfo/ds:X509Data/ds:X509Certificate` of the XML file. Supposing that the file was downloaded to `Downloads/OpenNebula Local.xml`, it can be done easily using the command `xpath` as shown in the following commandline
```bash
cat "Downloads/OpenNebula local.xml" | xpath -e '/EntityDescriptor/Signature/ds:KeyInfo/ds:X509Data/ds:X509Certificate/text()' 2>/dev/null
cat "Downloads/OpenNebula local.xml" | \
xpath -e '/EntityDescriptor/Signature/ds:KeyInfo/ds:X509Data/ds:X509Certificate/text()' 2>/dev/null
```
- On the __Set up OpenNebula local__ (or the name of the app that was chosen), the field **Microsoft Entra Identifier** will be needed for further configuration as the `:issuer` field for OpenNebula Entra identity provider

Expand Down