Self-host

Licence Organisations ou Premium

L'auto-hébergement de Bitwarden est gratuit, mais certaines fonctionnalités doivent être déverrouillées dans votre instance auto-hébergée avec un fichier de licence enregistré. Un fichier de licence peut être obtenu à partir de l'application Web hébergée par Bitwarden soit par un compte avec un abonnement individuel premium, soit par le propriétaire d'une organisation.

Les étapes sont différentes selon qu'il s'agit d'une licence individuelle ou d'une licence d'organisation.

note

The procedures in this article assume that you have already started a paid subscription to Bitwarden. If you haven't, refer to About Bitwarden Plans and What Plan is Right for Me?

Licence individuelle

Suivez ces procédures lorsque vous travaillez avec une licence individuelle pour un abonnement premium. Vous travaillerez à la fois dans le coffre-fort Web cloud et dans votre coffre-fort Web auto-hébergé, et les adresses e-mail de vos comptes doivent correspondre.

Récupérer une licence individuelle

Après avoir créé un compte sur votre serveur auto-hébergé, récupérez votre licence à partir de l'application Web cloud :

  1. Connectez-vous et sélectionnez ParamètresAbonnement dans la navigation.

  2. Sélectionnez Télécharger la licence bouton:

    Download personal license
    Download personal license

Appliquer une licence individuelle

Ensuite, connectez-vous à votre serveur Bitwarden auto-hébergé pour appliquer la licence téléchargée :

  1. Si vous ne l'avez pas déjà fait, vérifiez votre adresse e-mail. Vous devez avoir configuré les variables d'environnement liées au protocole SMTP.

  2. Sélectionnez ParamètresAbonnement dans la navigation.

  3. Dans la section Fichier de licence, sélectionnez le bouton Parcourir... ou Choisir un fichier et ajoutez le fichier de licence téléchargé.

  4. Sélectionnez le bouton Soumettre pour appliquer votre licence premium.

Mettre à jour la licence individuelle

Si pour une raison quelconque vous devez mettre à jour votre fichier de licence individuelle, par exemple lorsqu'il expire :

  1. Suivez les étapes pour Récupérer votre licence à nouveau.

  2. Suivez les étapes pour appliquer votre licence encore une fois, seulement cette fois vous verrez une licence de mise à jour bouton plutôt qu'un bouton pour rechercher une nouvelle licence.

Licence d'organisation

Suivez ces procédures lorsque vous travaillez avec une licence d'organisation pour une organisation Families ou Enterprise. Vous devez être le propriétaire de l'organisation pour récupérer, appliquer et mettre à jour une licence.

Récupérer la licence de l'organisation

Avant de démarrer une organisation sur votre serveur auto-hébergé, récupérez votre licence d'organisation à partir de l'application Web du nuage.

  1. Dans l'application Web Bitwarden, ouvrez la console d'administration à l'aide du sélecteur de produit :

    commutateur-de-produit
    commutateur-de-produit
  2. Accédez à FacturationAbonnement .

  3. Faites défiler la page vers le bas et sélectionnez le bouton Télécharger la licence .

  4. Lorsque vous y êtes invité, saisissez l'ID d'installation utilisé pour installer votre serveur auto-hébergé et sélectionnez Envoyer . Si vous ne connaissez pas l'ID d'installation par cœur, vous pouvez le récupérer à partir de ./bwdata/env/global.override.env .

note

Make sure that the installation ID you retrieved from bitwarden.com/host uses the same data region as where your organization exists.

Appliquer une licence d'organisation

L'application de votre licence sur un serveur auto-hébergé est le moyen par lequel vous créerez une organisation auto-hébergée. À partir de votre coffre-fort Web auto-hébergé :

  1. démarrez une nouvelle organisation en sélectionnant l'option Bouton Ajouter une organisation .

  2. Sélectionnez le bouton Parcourir... ou Choisir un fichier , ajoutez le fichier de licence téléchargé et sélectionnez Soumettre .

note

Si vous recevez un message d'erreur indiquant que la version n'est pas prise en charge, mettez à jour votre serveur et essayez à nouveau de télécharger votre fichier de licence. Pour mettre à jour votre serveur, faites une sauvegarde du répertoire bwdata et suivez les instructions suivantes.

Mettre à jour la licence de l'organisation

Les organisations devront mettre à jour le fichier de licence utilisé par leur serveur auto-hébergé dans plusieurs scénarios différents, par exemple :

  • Pour ajouter des sièges d'utilisateurs à une organisation auto-hébergée. Le nombre de sièges des organisations auto-hébergées est dicté par la licence, donc pour ajouter des sièges, ils doivent d'abord être ajoutés à l'organisation cloud associée, puis la licence utilisée par votre organisation auto-hébergée doit être mise à jour.

  • Pour poursuivre l'exploitation de l'organisation auto-hébergée lorsque la licence est renouvelée. Vous disposez de 60 jours, à compter de la date de renouvellement, pour mettre à jour le fichier de licence sur votre serveur auto-hébergé avant que votre organisation auto-hébergée ne soit désactivée.

Il existe deux méthodes pour mettre à jour la licence d'un organisme auto-hébergé, mais les organismes familiaux ne peuvent le faire que manuellement :

Automatic sync:

  • Eliminates the need for organization admins to manually re-upload licenses. Once setup, admins will only need to trigger a sync from the OrganizationBilling when an update to the license used by the self-hosted organization is required.

  • Makes Families sponsorships possible for members of self-hosted organizations. Sync for these sponsorships will automatically occur per day.

  • Cannot be setup by organizations still in a free trial period.

To set up automatic sync:

Step 1: Enable cloud communication

note

Cette étape doit être réalisée par une personne ayant accès aux fichiers de configuration de votre instance auto-hébergée.

Configure your server to allow communication with Bitwarden cloud systems by setting the following lines in bwdata/env/global.override.env:

Bash
globalSettings__enableCloudCommunication=true globalSettings__baseServiceUri__cloudRegion=US

If your cloud organization was created on EU servers, you'll need make the following changes to configure for communication with EU cloud servers:

  • Change the second of these lines to globalSettings__baseServiceUri__cloudRegion=EU.

  • Set the following 3 additional values:

    Bash
    globalSettings__installation__identityUri=https://identity.bitwarden.eu globalSettings__installation__apiUri=https://api.bitwarden.eu globalSettings__pushRelayBaseUri=https://push.bitwarden.eu
note

La valeur pour globalSettings__baseServiceUri__cloudRegion doit correspondre à la région de donnée qui a été sélectionnée lors de la récupération de votre ID d'installation & Clé.

Once you have set these value, apply your change by running the ./bitwarden.sh rebuild command. Start your server again with the ./bitwarden.sh start command.

note

L'activation de la synchronisation automatique nécessite une communication avec les systèmes en nuage de Bitwarden. Si votre environnement utilise un pare-feu pour bloquer le trafic sortant, vous devrez autoriser https://api.bitwarden.com ou .eu et https://identity.bitwarden.com ou .eu.

Step 2: Retrieve billing sync token

Once cloud communication is enabled at the server-level, a sync token needs to be passed from the cloud organization that is associated with your self-hosted organization. To retrieve your sync token from the cloud web app:

  1. Open the cloud Admin Console and navigate to BillingSubscription.

  2. In the self-hosting section, select Set up billing sync.

  3. Enter your master password and select Generate token.

  4. Copy the generated token.

Step 3: Apply billing sync token

To apply the billing sync token to your self-hosted organization:

  1. Open the self-hosted Admin Console and navigate to BillingSubscription.

  2. In the License and billing management section, choose the Automatic sync option.

  3. Select the Manage billing sync button.

  4. Paste your generated Billing Sync Token and select Save.

note

La synchronisation pour Families for Enterprise se fera une fois par jour une fois que vous aurez déclenché votre première synchronisation. Le champ Dernière synchronisation de cette section indiquera Jamais jusqu'à ce que vous déclenchiez votre première synchronisation.

La synchronisation des mises à jour de licence doit toujours être effectuée manuellement en sélectionnant le bouton Synchroniser la licence (voir la section suivante pour plus de détails).

Step 4: Trigger sync

Trigger a sync once you've completed setup and each time you need to update your license. Sync for Familes for Enterprise will occur once daily. To trigger a sync:

  1. Open the self-hosted Admin Console and navigate to OrganizationBilling.

  2. Select the Sync license button.

note

Si vous recevez un message d'erreur indiquant que la version n'est pas prise en charge, mettez à jour votre serveur et essayez à nouveau de télécharger votre fichier de licence. Pour mettre à jour votre serveur, faites une sauvegarde du répertoire bwdata et suivez les instructions suivantes.