Page History
Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BellaDati can be customised via set of application properties which can be set in one of the following ways (in order of precedence, some properties support only sub-set of these options):
Parameters in The file |
Parameter name | Description |
---|---|
| Specifies the URL on which is BellaDati running. The default value is http://localhost. |
| Determines whether BellaDati is running in production mode. The default value is |
| Determines whether BellaDati is running in SSL/TLS mode. If set to |
| URL of the SMTP server used for sending email. Default value is |
| SMTP server port. Default value is |
| Determines whether SSL is used for SMTP. Default value is |
| Username for accessing the SMTP server. |
| Password for accessing the SMTP server. |
| This parameter allows you to change the email sender address. |
| The value of this parameter is automatically appended to all outgoing emails. The default value is |
| Specifies the directory for report and data set indexes. Default value is |
| Consumer application ID for the Facebook connector. |
| Consumer application secret for the Facebook connector. |
| Consumer key for the Twitter connector. |
| Consumer secret for the Twitter connector. |
| Consumer key for the SalesForce connector. |
| Consumer secret for the SalesForce connector. |
core.membersLimit | Note that by increasing default value from 1000 to larger values. Users can use Attribute Looping Functions exp. eachMember() on larger datasets. Important: read best practices. You may need higher hardware configuration especially for multi-tenant BellaDati environment. |
core.joins.limit | Rows limit of the maximum join size |
core.joins.previewLimit | Joins preview limit - sometimes it is reasonable to use just the preview instead of materializing the join |
JDBC Settings
Anchor | ||||
---|---|---|---|---|
|
These settings allow to set JDBC connection to database used internally by BellaDati. It's an alternative to setting up a JDBC resource in the application server which requires manual addition of proper JDBC driver to the server's classpath.
JVM setting | Description |
---|---|
| JDBC driver used by BellaDati for database connections. Currently, only |
| If you don't have a JNDI data source configured, you can use the jdbc.url,jdbc.username and jdbc.password parameters. |
| Username used by BellaDati to access the database. This parameter is used only when |
| Password used by BellaDati to access the database. This parameter is used only when |
| Maximum number of active database connections. Recommended value is 200. |
| Minimum number of database connections in idle state. Recommended value is 8. |
| Maximum number of database connections in idle state. Recommended value is 8. |
| The minimum amount of time (in milliseconds) an idle database connection may sit idle in the pool before it is eligible for eviction by the idle object evictor (if any). Default value is 30 minutes. |
| The maximum number of milliseconds that the pool will wait (when there are no available connections) for a connection to be returned before throwing an exception, or -1 to wait indefinitely. Default value is 60000 milliseconds. |
| Name of the JNDI resource to access the database, e.g. jdbc/belladati_db. Specify only if you are using a JNDI data source. |
Cluster Mode
Parameter name | Description |
---|---|
| Specifies the URL on which is BellaDati running. The default value is http://localhost. |
| Determines whether BellaDati is running in production mode. The default value is |
| Determines whether BellaDati is running in SSL/TLS mode. If set to |
| JDBC driver used by BellaDati for database connections. Currently, only |
| If you don't have a JNDI data source configured, you can use the |
| Username used by BellaDati to access the database. This parameter is used only when |
| Password used by BellaDati to access the database. This parameter is used only when |
| Maximum number of active database connections. |
| Minimum number of database connections in idle state. |
| Maximum number of database connections in idle state. |
| Name of the JNDI resource to access the database, e.g. |
| URL of the SMTP server used for sending email. Default value is |
| SMTP server port. Default value is |
| Determines whether SSL is used for SMTP. Default value is |
| Username for accessing the SMTP server. |
| Password for accessing the SMTP server. |
| This parameter allows you to change the email sender address. |
| The value of this parameter is automatically appended to all outgoing emails. The default value is |
| Specifies the directory for report and data set indexes. Default value is |
| Consumer application ID for the Facebook connector. |
| Consumer application secret for the Facebook connector. |
| Consumer key for the Twitter connector. |
| Consumer secret for the Twitter connector. |
| Consumer key for the SalesForce connector. |
| Consumer secret for the SalesForce connector. |
core.membersLimit | Note that by increasing default value from 1000 to larger values. Users can use Attribute Looping Functions exp. eachMember() on larger datasets. Important: read best practices. You may need higher hardware configuration especially for multi-tenant BellaDati environment. |
core.joins.limit | Rows limit of the maximum join size |
core.joins.previewLimit | Joins preview limit - sometimes it is reasonable to use just the preview instead of materializing the join |
If you change the lucene.indexes parameter on a system that's already in use, you will need to reindex your reports and data sets. After restarting the server and logging in, move the mouse over your username and click the link to your domain. On the left side, reindex your reports and data sets.
ActiveDirectory/LDAP Authentication
Tip |
---|
Since version 2.7.9.1 you can configure the ActiveDirectory authentication directly from the user interface. See Setup Active Directory Authentication. |
BellaDati supports customizable authentication providers. Among the basic providers is the Active Directory and LDAP authentication provider. To enable this authentication provider, follow the instructions below:
BellaDati v2.7.4.1 and higher
1. Unzip the WEB-INF/classes/conf/application.properties
configuration file from the BellaDati WAR file or edit the WEB-INF/classes/conf/application.properties in your BellaDati installation directory.
| List of authentication domains - names are displayed on the login page. E.g. |
| Determines whether accounts that don't exist are automatically created. |
| Specifies the |
| Specifies the search URL, e.g. LDAP://adhost:389/OU=Unit,OU=test,DC=company,DC=com |
| The |
| The password of the user with search permission. |
| The login attribute, e.g. |
2. If you have extracted the application.properties file from belladati.war
archive, update this archive.
BellaDati v2.7.4 and below
1. Unzip the WEB-INF/classes/conf/beans-common.xml
configuration file from the BellaDati WAR file.
2. Replace the bean
element with id="userAuthenticityProvider"
with this content:
Code Block | ||||
---|---|---|---|---|
| ||||
<bean id="userAuthenticityVerifier" class="cz.trgiman.belladati.auth.ADUserAuthenticityVerifier" autowire="byType"> <property name="createNotExistingAccounts" value="true"/> <property name="workspaceId" value="1"/> <property name="domains"> <map> <entry> <key><value>domain1</value></key> <bean class="cz.trgiman.belladati.auth.DomainSpecification"> <property name="url" value="LDAP://host1:389/dc=xyz"/> <property name="bindDN" value="bindUser"/> <property name="bindPassword" value="bindUserPassword"/> <property name="loginAttribute" value="sAMAccountName"/> <property name="workspaceId" value="1"/> </bean> </entry> <entry> <key><value>domain2</value></key> <bean class="cz.trgiman.belladati.auth.DomainSpecification"> <property name="url" value="LDAP://host2:389/dc=xyz"/> <property name="bindDN" value="bindUser2"/> <property name="bindPassword" value="bindUserPassword2"/> <property name="loginAttribute" value="cn"/> <property name="workspaceId" value="1"/> </bean> </entry> </map> </property> </bean> |
3. Add the following parameter to the WEB-INF/classes/conf/application.properties
file:
Code Block |
---|
application.login.domains=domain1,domain2 |
4. Update the belladati.war
archive.
Sv translation | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
パラメーター名 | 説明 |
---|---|
| BellaDatiが実行されているところにURLを指定します。デフォルト値はhttp://localhostになります。 |
| BellaDatiがプロダクションモードで実行されているかどうかを決定します。デフォルト値はtrueになります。 |
| BellaDatiがSSL/ TLSモードで実行されているかどうかを決定します。trueに設定すると、アプリケーションがSSLを使用してオープンするすべてのページを強制します。このパラメータを使用するために、コンテナの使用SSL/ TLSを設定する必要がありますのでご注意ください。 |
| JDBCドライバがデータベース接続のためにBellaDatiによって使用されます。現在、org.postgresql.Driverのみがサポートされます。 |
| JNDIデータ・ソースを構成していない場合には、 |
| ユーザー名がデータベースにアクセスするためにBellaDatiによって使用されます。 jdbc.urlが設定されている場合、このパラメータのみに使用されます。 |
| パスワードがデータベースにアクセスするためにBellaDatiによって使用されます。 jdbc.urlが設定されている場合、このパラメータのみに使用されます。 |
| アクティブなデータベース接続の最大数 |
| アイドル状態のデータベース接続の最小数 |
| アイドル状態のデータベース接続の最小数。 |
| データベースにアクセスするためにJNDIリソースの名。例えば、jdbc/belladati dbなど。JNDIデータ・ソースを使用している場合のみに指定されます。 |
| SMTPサーバーのURLは、メールを送信するために使用されます。デフォルト値はlocalhostです。 |
| SMTPサーバのポート。デフォルト値は25とします |
| SMTPのためにSSLが使用されているかどうかを決定。デフォルト値はfalseとします。 |
| SMTPサーバーにアクセス用ユーザー名 |
| SMTPサーバーにアクセスする用パスワード |
| このパラメータを使用すると送信者のメールアドレスを変更できます。 support@belladati.comがデフォルトとして使用されています。 |
| このパラメータの値は、自動的にすべての送信メールに付加されます。デフォルト値は |
| レポートとデータセットのインデックス用ディレクトリを指定します。デフォルト値はインデックスとします。 |
| Facebookコネクタ用コンシューマアプリケーションID |
| Facebookコネクタ用秘密コンシューマアプリケーション |
| Twitterコネクタのコンシューマキー |
| Twitterコネクタ用コンシューマシークレット |
| Salesforceコネクタ用コンシューマキー |
| Salesforceコネクタ用コンシューマシークレット |
core.membersLimit | 1000からより大きな値までデフォルト値を増やすことに注意してください。ユーザーが大きなデータセットにexp. eachMember()属性ループ機能を使用できます。重要:ベストプラクティスをお読みください。特にマルチテナントBellaDati環境により高いハードウェア構成する必要があります。 |
既に使用中のシステムにlucene.indexesパラメータを変更する場合は、レポートやデータセットのインデックスを再作成する必要があります。サーバを再起動し、ログインした後、ユーザー名の上にマウスを移動し、ドメインへのリンクをクリックします。左側には、レポートやデータセットを再インデックスします。
アクティブディレクトリ/ LDAP認証
Tip |
---|
2.7.9.1バージョン以降、ユーザーインターフェイスから直接にActiveDirectoryの認証を設定できますActive Directory認証のセットアップを参照してください。 |
BellaDatiは、カスタマイズ認証プロバイダをサポートしています。基本的なプロバイダの中にActive DirectoryとLDAP認証プロバイダです。この認証プロバイダを有効にするには、以下の手順に従ってください。
BellaDati v2.7.4.1以降
1.
BellaDatiインストールディレクトリにBellaDati WARファイルからWEB-INF/classes/conf/application.properties
設定ファイルを解凍し、WEB-INF/classes/conf/application.propertiesを編集します。
| ドメインのリスト - 認証名がログインページに表示されます。例えば、 |
| 存在しないアカウントが自動的に作成されているかどうかを決定します。 |
| adauth.createNotExistingAccounts=trueの場合には、宛先ドメインのIDを指定します。 |
| 検索URLを指定します。例えば: |
| 検索権限を持つユーザーのDN |
| 検索権限を持つユーザーのパスワード |
| ログイン属性。例えば、 sAMAccountNameなど。 |
2. belladati.war
archiveからapplication.propertiesファイルを解凍している場合は、このアーカイブを更新します。
BellaDati v2.7.4または以下
1. BellaDati WARファイルからWEB-INF/classes/conf/beans-common.xml
設定ファイルを解凍します。
2. このコンテンツでのid="userAuthenticityProvider"
にbean要素を交換してください。
Code Block | ||||
---|---|---|---|---|
| ||||
<bean id="userAuthenticityVerifier" class="cz.trgiman.belladati.auth.ADUserAuthenticityVerifier" autowire="byType"> <property name="createNotExistingAccounts" value="true"/> <property name="workspaceId" value="1"/> <property name="domains"> <map> <entry> <key><value>domain1</value></key> <bean class="cz.trgiman.belladati.auth.DomainSpecification"> <property name="url" value="LDAP://host1:389/dc=xyz"/> <property name="bindDN" value="bindUser"/> <property name="bindPassword" value="bindUserPassword"/> <property name="loginAttribute" value="sAMAccountName"/> <property name="workspaceId" value="1"/> </bean> </entry> <entry> <key><value>domain2</value></key> <bean class="cz.trgiman.belladati.auth.DomainSpecification"> <property name="url" value="LDAP://host2:389/dc=xyz"/> <property name="bindDN" value="bindUser2"/> <property name="bindPassword" value="bindUserPassword2"/> <property name="loginAttribute" value="cn"/> <property name="workspaceId" value="1"/> </bean> </entry> </map> </property> </bean> |
3. WEB-INF/classes/conf/application.properties
ファイルに次のパラメータを追加します。
Code Block |
---|
application.login.domains=domain1,domain2 |
4. belladati.warアーカイブを更新します。