mirror of
https://github.com/Steffo99/sophon.git
synced 2024-12-21 22:34:21 +00:00
📔 Clean up some things
This commit is contained in:
parent
e82ce37fd0
commit
ed5f7bce6d
6 changed files with 39 additions and 37 deletions
|
@ -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/``).
|
||||
|
|
|
@ -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``
|
||||
----------------------------
|
||||
|
||||
|
|
|
@ -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}
|
||||
|
|
|
@ -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`.
|
||||
|
|
|
@ -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
|
Loading…
Reference in a new issue