Skip to content

Latest commit

 

History

History
70 lines (47 loc) · 4.73 KB

RELEASE.md

File metadata and controls

70 lines (47 loc) · 4.73 KB
Raw

Releases

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog.

[1.7]

Added

  • Spaces: A new way to manage your SIP domains and hosts. A Space is defined by a unique SIP Domain and Host pair.
    • New mandatory DotEnv variable APP_ROOT_HOST, replaces APP_URL and APP_SIP_DOMAIN that are now configured using the new dedicated Artisan script. It defines the root hostname where all the Spaces will be configured. All the Spaces will be as subdomains of APP_ROOT_HOST except one that can be equal to APP_ROOT_HOST. Example: if APP_ROOT_HOST=myhost.com the Spaces hosts will be myhost.com, alpha.myhost.com , beta.myhost.com...
    • New Artisan script php artisan spaces:create-update {sip_domain} {host} {--super}, replaces php artisan sip_domains:create-update {sip_domain} {--super}. Can create a Space or update a Space Host base on its Space SIP Domain.

Migrate from [1.6]

  1. Deploy the new version and migrate the database.
    php artisan migrate
  1. Set APP_ROOT_HOST in .env or as an environnement variable. And remove APP_URL and APP_SIP_DOMAIN
    APP_ROOT_HOST=myhost.com
  1. The migration script will automatically copy the sip_domain into host in the spaces table. You then have to "fix" the hosts and set them to equal or be subdomains of APP_ROOT_HOST.
    php artisan spaces:create-update my.sip myhost.com --super # You can set some Spaces as SuperSpaces, the admin will be able to manage the other spaces
    php artisan spaces:create-update alpha.sip alpha.myhost.com
    php artisan spaces:create-update beta.sip beta.myhost.com
    ...

  1. Configure your web server to point the APP_ROOT_HOST and subdomains to the app.

  2. Configure the upcoming Spaces

[1.5] - 2024-08-29

Added

  • Account activity view: new panel, available behind the Activity tab, will allow any admin to follow the activity of the accounts they manage.
  • Detect and block abusive accounts: This activity tracking is coming with a related tool that is measuring the accounts activity and automatically block them if it detects some unusual behaviors on the service. An account can also directly be blocked and unblocked from the setting panel. Two new setting variables will allow you to fine tune those behaviors triggers.
    • New DotEnv variable: BLOCKING_TIME_PERIOD_CHECK=30 Time span on which the blocking service will proceed, in minutes
    • New DotEnv variable: BLOCKING_AMOUNT_EVENTS_AUTHORIZED_DURING_PERIOD=5 Amount of account events authorized during this period
  • OAuth JWT Authentication: OAuth support with the handling of JWE tokens issues by a third party service such as Keycloack.
    • New DotEnv variable: JWT_RSA_PUBLIC_KEY_PEM=
    • New DotEnv variable: JWT_SIP_IDENTIFIER=sip_identifier
  • Super-domains and super-admins support: Introduce SIP domains management. The app accounts are now divided by their domains with their own respective administrators that can only see and manage their own domain accounts and settings. On top of that it is possible to configure a SIP domain as a "super-domain" and then allow its admins to become "super-admins". Those super-admins will then be able to manage all the accounts handled by the instance and create/edit/delete the other SIP domains. Add new endpoints and a new super-admin role in the API to manage the SIP domains. SIP domains can also be created and updated directly from the console using a new artisan script (documented in the README);
    • New Artisan script: php artisan sip_domains:create-update {domain} {--super}
  • Account Dictionary: Each account can now handle a specific dictionary, configurable by the API or directly the web panel. This dictionary allows developers to store arbitrary key -> value pairs on each accounts.
  • Vcard storage: Attach custom vCards on a dedicated account using new endpoints in the API. The published vCard are validated before being stored.

Changed

  • User management of their own devices: Allowing users will be able to manage its own devices. Specific API endpoints were also added to manage them directly from the clients.
  • Migration to hCaptcha: Migrate from Google Recaptcha to hCaptcha in this release.
    • New DotEnv variable: HCAPTCHA_SECRET=secret-key
    • New DotEnv variable: HCAPTCHA_SITEKEY=site-key
  • Localization support: The API is now accepting the Accept-Language header and adapt its internal localization to the client/browser one. For the moment only French and English are supported but more languages could be added in the future.

Deprecated

  • Last major version supporting the deprecated endpoints of the API