1
Fork 0
mirror of https://github.com/Steffo99/sophon.git synced 2024-10-16 07:07:26 +00:00

📔 Clean up some things

This commit is contained in:
Steffo 2021-11-03 22:11:10 +01:00
parent e82ce37fd0
commit ed5f7bce6d
6 changed files with 39 additions and 37 deletions

View file

@ -1,17 +1,17 @@
Configurazione DNS
==================
Si scelga il dominio (o sottodominio) sul quale si vuole che Sophon sia accessibile e si aggiungano i seguenti record DNS, sostituendo il dominio scelto a ``DOMINIO`` e gli indirizzi IPv4 e IPv6 del server al posto di `0.0.0.0` e `1234::1234`:
Si scelga il dominio (o sottodominio) sul quale si vuole che Sophon sia accessibile e si aggiungano i seguenti record DNS, sostituendo il dominio ``ilmiosophon.it`` con il proprio nome di dominio, e gli indirizzi IPv4 e IPv6 del server al posto di `0.0.0.0` e `1234::1234`:
.. code-block:: dns
*.DOMINIO 1800 IN A 0.0.0.0
*.DOMINIO 1800 IN AAAA 1234::1234
DOMINIO 1800 IN A 0.0.0.0
DOMINIO 1800 IN AAAA 1234::1234
*.ilmiosophon.it 1800 IN A 0.0.0.0
*.ilmiosophon.it 1800 IN AAAA 1234::1234
ilmiosophon.it 1800 IN A 0.0.0.0
ilmiosophon.it 1800 IN AAAA 1234::1234
Sophon sarà accessibile ai seguenti indirizzi:
Sophon sarà quindi accessibile ai seguenti indirizzi:
- l'interfaccia web a ``https://DOMINIO/``;
- l'API a ``https://api.DOMINIO/``;
- i notebook a ``https://SLUG.DOMINIO/``.
- l'interfaccia web al dominio base (``https://ilmiosophon.it/``);
- l'API al dominio base prefisso con ``api.`` (``https://api.ilmiosophon.it/``);
- i notebook al dominio base prefissi con lo slug del notebook (``https://ilmionotebook.ilmiosophon.it/``).

View file

@ -39,11 +39,11 @@ Specifica la chiave segreta da usare per i cookie di sessione.
``DJANGO_PROXY_BASE_DOMAIN``
----------------------------
Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il ``DOMINIO`` per il quale si è configurato il DNS in precedenza.
Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il dominio per il quale si è configurato il DNS in precedenza.
.. code-block:: yml
- DJANGO_PROXY_BASE_DOMAIN=prod.sophon.steffo.eu
- DJANGO_PROXY_BASE_DOMAIN=ilmiosophon.it
.. note::
@ -59,7 +59,7 @@ Specifica il dominio che dovrà essere usato come radice per il proxy, ovvero il
Specifica il protocollo che dovrà essere usato nei mapping del proxy.
Si consiglia caldamente di utilizzare ``https``, ma è un valore valido anche ``http``.
Si consiglia vivamente di utilizzare ``https``, ma è un valore valido anche ``http``.
.. code-block:: yml
@ -73,11 +73,11 @@ Specifica i domini da cui possono provenire le richieste alla pagina di amminist
Per specificare più domini, è necessario separarli con dei pipe ``|`` .
Eccetto in configurazioni speciali, deve essere uguale a ``api.DOMINIO``.
Eccetto in configurazioni speciali, deve essere uguale al dominio prefisso da ``api.``.
.. code-block:: yml
- DJANGO_ALLOWED_HOSTS=api.prod.sophon.steffo.eu
- DJANGO_ALLOWED_HOSTS=api.ilmiosophon.it
.. seealso::
@ -91,11 +91,11 @@ Specifica i domini da cui possono provenire le richieste all'API.
Per specificare più domini, è necessario separarli con dei pipe ``|`` .
Eccetto in configurazioni speciali, deve essere uguale a ``PROTOCOLLO://DOMINIO|https://sophon.steffo.eu``.
Eccetto in configurazioni speciali, deve contenere il proprio dominio prefisso dal protocollo, e in aggiunta il dominio speciale ``https://sophon.steffo.eu``, necessario per permettere l'accesso dall'interfaccia web "universale" di Sophon.
.. code-block:: yml
- DJANGO_ALLOWED_ORIGINS=https://prod.sophon.steffo.eu|https://sophon.steffo.eu
- DJANGO_ALLOWED_ORIGINS=https://ilmiosophon.it|https://sophon.steffo.eu
.. seealso::
@ -107,15 +107,15 @@ Eccetto in configurazioni speciali, deve essere uguale a ``PROTOCOLLO://DOMINIO|
Specifica l'URL a cui saranno accessibili i file statici di Sophon.
Eccetto in configurazioni speciali, deve essere uguale a ``PROTOCOLLO://static.DOMINIO/django-static/``.
Eccetto in configurazioni speciali, deve essere uguale alla seguente stringa, con le parole in maiuscolo sostituite rispettivamente dal protocollo e dal dominio selezionato: ``PROTOCOLLO://static.DOMINIO/django-static/``.
.. code-block:: yml
- DJANGO_ALLOWED_ORIGINS=http://static.prod.sophon.steffo.eu/django-static/
- DJANGO_ALLOWED_ORIGINS=http://static.ilmiosophon.it/django-static/
.. warning::
Ci si assicuri di inserire la barra finale, altrimenti Sophon non funzionerà correttamente!
Ci si assicuri che sia presente uno slash al termine della stringa, oppure il pannello di amministrazione non sarà visualizzato correttamente!
.. seealso::
@ -133,10 +133,6 @@ Usa il formato `language code`_ di Django.
- DJANGO_LANGUAGE_CODE=en-us
.. tip::
Generalmente è una buona idea impostarlo a ``en-us`` per facilitare la risoluzione di eventuali problemi.
.. seealso::
`LANGUAGE_CODE <https://docs.djangoproject.com/en/3.2/ref/settings/#language-code>`_ nella documentazione di Django
@ -153,7 +149,7 @@ Usa il formato `tzdata`_.
.. code-block:: yml
- DJANGO_TIME_ZONE=Europe/Rome
- DJANGO_TIME_ZONE=Europe/Paris
.. hint::
@ -200,6 +196,18 @@ Specifica la password del :ref:`superutente` che verrà automaticamente creato q
La password è un dato estremamente riservato, in quanto chiunque ne venga a conoscenza potrà accedere a Sophon con pieni privilegi!
``REACT_APP_DEFAULT_INSTANCE``
------------------------------
Specifica il valore con cui precompilare il campo "selezione istanza" dell'interfaccia web di Sophon.
Eccetto in configurazioni speciali, deve essere uguale al dominio prefisso dal protocollo e da ``api.``.
.. code-block:: yml
- REACT_APP_DEFAULT_INSTANCE=https://api.ilmiosophon.it
``APACHE_PROXY_BASE_DOMAIN``
----------------------------

View file

@ -20,8 +20,8 @@ Si aggiungano i seguenti ``VirtualHost`` alla configurazione:
.. code-block:: apacheconf
<VirtualHost *:80>
ServerName "DOMINIO"
ServerAlias "*.DOMINIO"
ServerName "ilmiosophon.it"
ServerAlias "*.ilmiosophon.it"
RewriteEngine On
RewriteRule ^(.*)$ https://%{HTTP_HOST}$1 [R=301,L]
@ -30,12 +30,12 @@ Si aggiungano i seguenti ``VirtualHost`` alla configurazione:
.. code-block:: apacheconf
<VirtualHost *:443>
ServerName "DOMINIO"
ServerAlias "*.DOMINIO"
ServerName "ilmiosophon.it"
ServerAlias "*.ilmiosophon.it"
SSLEngine on
SSLCertificateFile "/PERCORSO/ALLA/CATENA/DI/CHIAVI/PUBBLICHE/SSL"
SSLCertificateKeyFile "/PERCORSO/ALLA/CHIAVE/PRIVATA/SSL"
SSLCertificateFile "/SOSTITUISCIMI/CON/IL/PERCORSO/ALLA/FULL/CHAIN/SSL"
SSLCertificateKeyFile "/SOSTITUISCIMI/CON/IL/PERCORSO/ALLA/CHIAVE/PRIVATA/SSL"
ProxyPreserveHost On
RequestHeader set "X-Forwarded-Proto" expr=%{REQUEST_SCHEME}

View file

@ -1,4 +1,4 @@
Verificare il funzionamento
===========================
Se tutto è stato configurato correttamente, l'interfaccia utente Sophon dovrebbe essere raggiungibile al ``DOMINIO`` specificato, e dovrebbe essere possibile effettuare il login con le credenziali del primo :ref:`superutente` configurate.
Se tutto è stato configurato correttamente, l'interfaccia web Sophon dovrebbe essere raggiungibile al dominio selezionato (``https://ilmiosophon.it``), e dovrebbe essere possibile effettuare il login con le credenziali configurate del primo :ref:`superutente`.

View file

@ -1,6 +0,0 @@
Personalizzazione
=================
È possibile personalizzare l'istanza come descritto nella sezione :ref:`Personalizzazione dell'istanza` modificando l'unica voce del tipo **Sophon instance details** all'interno di **Sophon Core**.
.. image:: customization.png