diff --git a/README.md b/README.md index 7c027b7..5c11f94 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,26 @@ -:warning: This plugin needs the new modular driver system to work, which is available since Metabase version 0.32. - # Firebird driver for metabase This driver enables metabase to connect to [FirebirdSQL](https://firebirdsql.org/) databases. ## Installation: -* Make sure you have installed a recent Metabase Version that supports drivers as plugins. (>=0.32) -* Download the [latest release](https://github.com/evosec/metabase-firebird-driver/releases/latest) of the Firebird driver or build it from source. (See below) +* Make sure you have installed a recent Metabase Version. +* Download the [latest release](https://github.com/evosec/metabase-firebird-driver/releases/latest) of the Firebird driver or [build it from source](#building-from-source). * Create the `plugins` directory if it doesn't already exist. By default that directory is next to the metabase.jar file, but you can specify a different directory by setting the environment varianble `MB_PLUGINS_DIR`. * Just drop the `firebird.metabase-driver.jar` in the plugins directory. On startup, metabase will load the plugin and the driver should be available. ## Authentication issues when using Legacy_Auth -The latest releases are built with version 4.x of Jaybird (the Firebird JDBC driver), [which no longer supports Legacy_Auth](https://www.firebirdsql.org/file/documentation/drivers_documentation/java/4.0.0/release_notes.html#removed-legacy_auth-from-default-authentication-plugins). +The latest releases are built with version 4.x of Jaybird (the Firebird JDBC driver), [which no longer supports Legacy_Auth](https://www.firebirdsql.org/file/documentation/drivers_documentation/java/4.0.0/release_notes.html#removed-legacy_auth-from-default-authentication-plugins). + +:warning: First of all: Legacy_Auth is disabled for a reason. You should only use the following workarounds if you have no way of using a more secure authentication method. :warning: + +If you really need to access your database using Legacy_Auth ([#14](https://github.com/evosec/metabase-firebird-driver/issues/14)) you can [add it to the authentication plugins](https://www.firebirdsql.org/file/documentation/drivers_documentation/java/4.0.0/release_notes.html#configure-authentication-plugins). For example: +``` +jdbc:firebirdsql://localhost/employee?authPlugins=Legacy_Auth +``` -If you have problems accessing your database ([#14](https://github.com/evosec/metabase-firebird-driver/issues/14)) you can use the release artifact `firebird.metabase-driver_jaybird-3.jar` which is built with Jaybird 3.x. +If that does not work for you, you can use the release artifact `firebird.metabase-driver_jaybird-3.jar` which is built with Jaybird 3.x. ## Building from source: @@ -23,7 +28,7 @@ For a detailed description, take a look at the [official documentation](https:// #### Prepare a local Metabase installation for building drivers -* Download the Metabase sources (>=0.32) +* Download the Metabase sources * Compile a local Metabase installation for building drivers ``` lein install-for-building-drivers