Server farm
Una server farm è un gruppo di tuoi server che condividono le chiavi di accesso: una chiave funziona su ogni server della sua farm. La farm decide anche il certificato contenuto nelle sue chiavi e le impostazioni con cui funzionano i suoi server.
Dove trovarle
Apri Server Farms. Ogni progetto parte con una farm, Server Farm 1, ed è tutto ciò che ti serve finché alcuni server non hanno bisogno di chiavi proprie. L'elenco mostra il profilo server di ogni farm, quanti server ha e quante delle sue chiavi sono state usate dalle app negli ultimi sette giorni.
Seleziona una farm per aprirne la pagina. Le sue impostazioni si trovano sotto Server Farm e i suoi certificati sotto SSL / TLS Certificates, come spiega Certificati SSL/TLS.
203.0.113.10, e Push token to clients è attivo.
Quando aggiungere una farm
Una chiave funziona solo sui server della sua farm. Aggiungi una farm per i server i cui utenti non devono raggiungere gli altri tuoi server, o per i server che hanno bisogno di un proprio dominio o di impostazioni proprie: le chiavi di una farm contengono un solo certificato, e i suoi server condividono un unico profilo server.
Crea una farm
Apri Server Farms, seleziona Add, dai un nome alla farm e seleziona OK. MANAGER apre la pagina della nuova farm.
Una nuova farm usa il profilo server predefinito del progetto, ha Push token to clients attivo e ha un certificato autofirmato con un nome fittizio, contenuto nelle sue chiavi finché non usi il tuo dominio.
Non può distribuire chiavi finché non ha un server: MANAGER crea le chiavi dagli indirizzi dei suoi server. Finché uno di essi non è installato, la pagina della farm mostra un messaggio in rosso sotto il nome.
I server della farm
Ogni server appartiene a una sola farm. Quando aggiungi un server, scegli la sua Server Farm; il campo compare non appena il progetto ha più di una farm.
Per spostare un server in un'altra farm, apri il server e modifica la sua Server Farm. Il server prende il certificato e il profilo server della nuova farm, e le chiavi della vecchia farm smettono di funzionare su di esso. MANAGER rifiuta lo spostamento finché il server ha certificati propri: eliminali prima.
Se era l'unico server della vecchia farm con un indirizzo nelle chiavi, le chiavi della vecchia farm non raggiungono più alcun server finché un altro dei suoi server non ne ha uno.
Le chiavi della farm
Ogni chiave di accesso appartiene a una sola farm e funziona su tutti i suoi server. Scegli la farm quando crei la chiave in Access Tokens; il campo compare non appena il progetto ha più di una farm.
Una chiave contiene ciò che serve alle app per raggiungere la farm: gli indirizzi dei suoi server che finiscono nelle chiavi, e il dominio e l'impronta digitale del suo certificato. La sezione Access Points della farm li mostra. Punti di accesso spiega quali indirizzi vi entrano, e Certificati SSL/TLS quale certificato.
Una chiave spostata in un'altra farm, modificando la sua Server Farm, smette di funzionare sui server della vecchia farm, e MANAGER non può aggiornarla da lì: consegnala di nuovo ai suoi utenti.
Invio del token alle app (Push token to clients)
Una chiave contiene gli indirizzi e il certificato che la sua farm aveva quando l'hai copiata. Con Push token to clients, nella pagina della farm, MANAGER dà a ogni app gli indirizzi e il certificato attuali della farm quando si connette, così le app si aggiornano dopo una modifica senza che tu debba dare nuove chiavi. È attivo per ogni nuova farm.
MANAGER invia la nuova chiave solo quando tutti i server il cui indirizzo è nelle chiavi sono in funzione, così le app ricevono solo indirizzi che funzionano già. Una chiave senza indirizzo, solo con un dominio, come dietro un reverse proxy, non aspetta.
Un'app riceve la nuova chiave solo connettendosi con quella che ha. Quindi, dopo una modifica, mantieni il vecchio indirizzo o il vecchio certificato per qualche giorno, come mostra Modificare un indirizzo, oppure assegna alla farm degli URL del token.
URL del token della farm
Un URL del token della farm punta a un file sul web in cui MANAGER pubblica gli indirizzi e il certificato attuali della farm, cifrati in modo che solo le chiavi della farm possano leggerli. Ogni chiave della farm contiene gli URL, e un'app che non riesce a connettersi li legge e riprova con ciò che trova, anche quando tutti gli indirizzi che conosceva sono spariti o bloccati.
Nella pagina della farm, seleziona Farm Token Urls, poi Add. Publish Url è il punto da cui le app leggono il file: su un sito o una CDN che i tuoi utenti possono raggiungere. Compila Name e scegli con Auto Upload come il file arriva lì:
- Off: metti tu il file lì. Seleziona Farm Token nella pagina della farm e poi Download, e ripeti dopo ogni modifica.
- POST, PUT o PUT & POST: MANAGER carica il file dopo ogni modifica, con la richiesta descritta da File Url e dai campi intorno. Per un file in un repository GitHub, GitLab o Bitbucket, MANAGER compila questi campi a partire da Publish Url, e tu aggiungi solo un Access Token che possa scrivere il file.
L'elenco mostra se ogni file contiene il token attuale della farm. Il file potrebbe essere in cache, quindi ricontrolla qualche minuto dopo una modifica.
Le chiavi contengono gli URL che la farm aveva quando le hai copiate, quindi aggiungi gli URL prima di distribuire le chiavi. Le app con una chiave precedente li ricevono tramite Push token to clients.
Rinomina o elimina una farm
Per rinominare una farm, modifica il campo Name. Per eliminarla, seleziona Delete nella sua pagina: MANAGER elimina con essa le sue chiavi, e la conferma indica quante sono. Una farm con dei server non può essere eliminata: spostali prima in un'altra farm, oppure eliminali.
