Changes for page Guide d'installation Linux
Last modified by Aurelie Bertrand on 2024/11/25 11:18
From version 5.1
edited by Aurelie Bertrand
on 2024/07/10 16:38
on 2024/07/10 16:38
Change comment:
There is no comment for this version
To version 20.1
edited by Aurelie Bertrand
on 2024/08/20 14:52
on 2024/08/20 14:52
Change comment:
There is no comment for this version
Summary
-
Page properties (2 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 - Guide d'installation Linux1 +Installation guide for Linux - Content
-
... ... @@ -111,7 +111,7 @@ 111 111 ==== Reverse Proxy Valve ==== 112 112 113 113 {{code language="shell"}} 114 -# Add this valve in the Host element towardsthe end of the file114 +# Add this valve in the Host element near the end of the file 115 115 <Valve className="org.apache.catalina.valves.RemoteIpValve" 116 116 internalProxies="127\.0\.[0-1]\.1" 117 117 remoteIpHeader="X-Forwarded-For" ... ... @@ -140,11 +140,11 @@ 140 140 ==== Log Valve ==== 141 141 142 142 {{code language="shell"}} 143 -# Add this valve in the Host element towardsthe end of the file143 +# Add this valve in the Host element near the end of the file 144 144 <Valve className="org.apache.catalina.valves.ErrorReportValve" showReport="false" showServerInfo="false" ></Valve> 145 145 {{/code}} 146 146 147 -==== Limit the localhost_access_log file (optional) ==== 147 +==== Limiting the localhost_access_log file (optional) ==== 148 148 149 149 To limit the size of the localhost_access_log file, add the //maxDays// parameter to the Access Log Valve and give it the value of the desired number of days. 150 150 ... ... @@ -156,7 +156,7 @@ 156 156 157 157 {{/code}} 158 158 159 -=== Editing context.xml === 159 +=== Editing the context.xml file === 160 160 161 161 (% class="wikigeneratedid" id="HEmplacement:2Fetc2Ftomcat92Fcontext.xml" %) 162 162 Location: /etc/tomcat9/context.xml ... ... @@ -201,7 +201,7 @@ 201 201 sudo systemctl restart tomcat9.service 202 202 {{/code}} 203 203 204 -=== Enabling automatic s tart service on startup ===204 +=== Enabling automatic service start on startup === 205 205 206 206 {{code language="shell"}} 207 207 sudo systemctl enable tomcat9 ... ... @@ -286,462 +286,322 @@ 286 286 287 287 = OpenDJ{{id name="OpenDJ"/}} = 288 288 289 -(% style="line-height:1.2" %) 290 290 == Installation == 291 291 292 -1. Start by getting the latest version of the **opendj-4.x.x_all.deb **file from the website [[https:~~/~~/github.com/OpenIdentityPlatform/OpenDJ/releases>>url:https://github.com/OpenIdentityPlatform/OpenDJ/releases]] :((( 293 -|(% style="background-color:black" %)(% style="color:#ffffff" %)wget https:~/~/github.com/OpenIdentityPlatform/OpenDJ/releases/download/4.x.x/opendj-4.x.x_all.deb 294 -))) 295 -1. Run the installation : ((( 296 -|(% style="background-color:black" %)(% style="color:#ffffff" %)sudo dpkg -i opendj_4.x.x_all.deb 297 -))) 291 +1. Start by getting the latest version of the **opendj-4.x.x_all.deb **file from the website [[https:~~/~~/github.com/OpenIdentityPlatform/OpenDJ/releases>>url:https://github.com/OpenIdentityPlatform/OpenDJ/releases]] : 298 298 293 +{{code language="shell"}} 294 +wget https://github.com/OpenIdentityPlatform/OpenDJ/releases/download/4.x.x/opendj-4.x.x_all.deb 295 +{{/code}} 296 + 297 +(% start="2" %) 298 +1. Run the installation : 299 + 300 +{{code language="shell"}} 301 +sudo dpkg -i opendj_4.x.x_all.deb 302 +{{/code}} 303 + 299 299 ((( 300 300 (% style="color:inherit; font-family:inherit; font-size:26px" %)Initial setup 301 301 ))) 302 302 303 -Launch the settings utility to follow the steps: 308 +To simplify OpenDJ configuration, we are going to create a ‘setupOpenDJ.props’ file containing the options available to respond to the OpenDJ ‘setup’ utility (this avoids the configuration interface). 309 +The contents of this file are detailed below: 304 304 311 +(% class="box warningmessage" %) 305 305 ((( 306 - |(%style="background-color:black"%)(% style="color:#ecf0f1"%)sudo/opt/opendj/setup313 +❗Don't forget to replace the parameters with your own. For example, replace the password with the one you want (here ‘adminOpenDJ1’). 307 307 ))) 308 308 309 -(% style="line-height:1.38" %) 310 -(% style="border:none; color:#000000; display:inline-block; font-family:Arial,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; height:49px; overflow:hidden; text-decoration:none; white-space:pre-wrap; width:602px" %)[[image:1.png]](%%) 311 -[Enter] 312 - 316 +{{code language="shell"}} 317 +# 318 +# Sample properties file to set up OpenDJ directory server 319 +# See OpenDJ Setup command man for more options 320 +# 321 +rootUserDN =cn=Directory Manager 322 +rootUserPassword =adminOpenDJ1 323 +hostname =localhost.localdomain 324 +ldapPort =389 325 +adminConnectorPort =4444 326 +backendType =je 327 +baseDN =dc=digdash,dc=com 328 +addBaseEntry =true 329 +ldapsPort =636 330 +enableStartTLS =false 331 +generateSelfSignedCertificate =true 332 +start =true 333 +#sampleData =2000 334 +{{/code}} 313 313 314 - [[image:2.png]]336 +After saving the file, run the following command line: 315 315 316 - (%style="line-height:1.38"%)317 - adminOpenDJ1318 - 338 +{{code language="shell"}} 339 +sudo /opt/opendj/setup --cli --propertiesFilePath setupOpenDJ.props --acceptLicense --no-prompt 340 +{{/code}} 319 319 320 -[[image:3.png]] 342 +(% style="line-height:1.38; text-indent:-14.173228346456689pt; margin-top:13px; margin-bottom:13px; padding:0pt 0pt 0pt 14.173228346456689pt" %) 343 +== Additional setup == 321 321 322 -(% style="line-height:1.38" %) 323 -[Enter] 324 - 345 +1. Go to the OpenDJ installation directory: 325 325 326 -[[image:4.png]] 347 +{{code language="shell"}} 348 +cd /opt/opendj/bin/ 349 +{{/code}} 327 327 328 -389 329 - 330 - 331 -[[image:5.png]] 332 - 333 -4444 334 - 335 - 336 -[[image:6.png]] 337 - 338 -[Enter] 339 - 340 - 341 -[[image:7.png]] 342 - 343 -(% style="line-height:1.38" %) 344 -[Enter] 345 - 346 - 347 -[[image:8.png]] 348 - 349 -dc=digdash,dc=com 350 - 351 -[[image:9.png]] 352 - 353 -2 354 - 355 - 356 -(% style="border:none; color:#000000; display:inline-block; font-family:Arial,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; height:42px; overflow:hidden; text-decoration:none; white-space:pre-wrap; width:445px" %)[[image:https://lh7-us.googleusercontent.com/gs7BVYjtXGYivvccymzaxjIwiLn_ld-xJryFXxP8_aqZekStBkjWRjqRG-isbpEk97CVrMOFCsyCy-uzdIoltTdVWhurhNF_ycRAHaBeARw25JvamLrGFXuc-TIL7h6NQEb5iwhIMZIJOblCKog-n5c||height="42" width="445"]](%%) 357 -oui 358 - 359 - 360 -[[image:11.png]] 361 - 362 -(% style="line-height:1.38" %) 363 -[Enter] 364 - 365 - 366 -[[image:12.png]] 367 - 368 -[Enter] 369 - 370 - 371 -[[image:13.png]] 372 - 373 -[Enter] 374 - 375 - 376 -[[image:14.png]] 377 - 378 -[Enter] 379 - 380 - 381 -[[image:15.png]] 382 - 383 -(% style="line-height:1.38" %) 384 -[Enter] 385 - 386 -(% style="line-height:1.38; text-indent:-14.173228346456689pt; margin-top:13px; margin-bottom:13px; padding:0pt 0pt 0pt 14.173228346456689pt" %) 387 -== Additional settings == 388 - 389 -1. Go to the OpenDJ installation directory:((( 390 -|(% style="background-color:black" %)(% style="color:#ffffff" %)cd /opt/opendj/bin/ 391 -))) 351 +(% start="2" %) 392 392 1. ((( 393 -LDIF files can be downloaded by clicking the following link [[LDIF_OpenDJ>>attach:LDIF_OpenDJ.zip]]. 353 +LDIF files can be downloaded by clicking on the following link [[LDIF_OpenDJ>>attach:/xwiki/wiki/dd2024r1/download/Digdash/deployment/installation/install_guide_ubuntu/WebHome/LDIF_OpenDJ.zip?rev=1.1]]. 394 394 ))) 395 -1. Create the organizations using the “neworganization.ldif” file below:((( 396 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN(%%) (% style="color:#2ecc71" %)"cn=Directory Manager" (% style="color:#ffffff" %)~-~-bindPassword adminOpenDJ1 neworganisation.ldif 355 +1. Create organisations using the ‘neworganisation.ldif’ file below : 397 397 398 - |(%style="background-color:black"%)(((399 - (%style="line-height:1.38"%)400 - (% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: ou=default,dc=digdash,dc=com//357 +{{code language="shell"}} 358 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" neworganisation.ldif 359 +{{/code}} 401 401 402 - (% style="line-height:1.38" %)403 - (% style="color:#ffffff; font-family:Consolas,sans-serif;font-size:11pt;font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: organizationalUnit//361 +{{code}} 362 +dn: ou=default,dc=digdash,dc=com 404 404 405 -(% style="line-height:1.38" %) 406 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ou: default// 407 -))) 408 -))) 364 +objectClass: organizationalUnit 409 409 366 +ou: default 367 +{{/code}} 368 + 410 410 (% start="4" %) 411 -1. To create a password checker: 412 -1*. Use the dsconfig.bat command, then log in with the Directory Manager credentials and accept the certificates. 413 -1*. Go to menu 29 then select “create a new Password Validator” > select “Character Set Password Validator” > enter “Custom Character Set Password Validator” > “true” > “true” > then configure 4 character-set as follows : ((( 414 -|(% style="background-color:black" %)(% style="color:#ffffff" %)1:abcdefghijklmnopqrstuvwxyz 415 -1:ABCDEFGHIJKLMNOPQRSTUVWXYZ 416 -1:0123456789 417 -1:!"#$%&'()*+,-./:;\<=>?@[]^_`{~|}~~ 370 +1. Set the password checker "Custom Character-set Password Validator": 418 418 419 - ➡ Theresult shouldlook like this :420 - (%style="border:none;color:#000000;display:inline-block;font-family:Consolas,sans-serif;font-size:10pt;font-style:italic;font-variant:normal; font-weight:400;height:114px;overflow:hidden;text-decoration:none;white-space:pre-wrap;width:454px"%)//[[image:Resultats.png]]//421 - )))372 +{{code language="shell"}} 373 +sudo /opt/opendj/bin/dsconfig create-password-validator --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --validator-name "Custom Character-set Password Validator" --set character-set:1:abcdefghijklmnopqrstuvwxyz --set character-set:1:ABCDEFGHIJKLMNOPQRSTUVWXYZ --set character-set:1:0123456789 --set "character-set:1:\!\"#$%&'()*+,-./:;<=>?@[]^_\`{|}~" --set enabled:true --type character-set --no-prompt --trustAll --set allow-unclassified-characters:true 374 +{{/code}} 422 422 423 -((( 424 - 425 -))) 426 - 427 427 (% start="5" %) 428 -1. For the second password checker, we can use a command line because it does not contain special characters: ((( 429 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/dsconfig create-password-validator ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ~-~-validator-name "Custom length Password Validator" ~-~-set min-password-length:12 ~-~-set enabled:true ~-~-type length-based ~-~-no-prompt 430 -))) 377 +1. Set the second password checker "Custom length Password Validator": 431 431 379 +{{code language="shell"}} 380 +sudo /opt/opendj/bin/dsconfig create-password-validator --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --validator-name "Custom length Password Validator" --set min-password-length:12 --set enabled:true --type length-based --no-prompt 381 +{{/code}} 382 + 432 432 (% start="6" %) 433 -1. Apply both password checkers:((( 434 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/dsconfig set-password-policy-prop ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ~-~-policy-name "Default Password Policy" ~-~-set password-validator:"Custom Character-set Password Validator" ~-~-set password-validator:"Custom length Password Validator" ~-~-no-prompt 435 -))) 384 +1. Apply the two password checkers : 436 436 386 +{{code language="shell"}} 387 +sudo /opt/opendj/bin/dsconfig set-password-policy-prop --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --policy-name "Default Password Policy" --set password-validator:"Custom Character-set Password Validator" --set password-validator:"Custom length Password Validator" --no-prompt 388 +{{/code}} 389 + 437 437 (% start="7" %) 438 -1. Set the password policy for users using the “ppolicy.ldif” file below:((( 439 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ppolicy.ldif 391 +1. Set the password policy for users using the ‘ppolicy.ldif’ file below: 440 440 441 - |(%style="background-color:black"%)(((442 - (%style="line-height:1.38"%)443 - (% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn:cn=ppolicy,ou=default,dc=digdash,dc=com//393 +{{code language="shell"}} 394 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" ppolicy.ldif 395 +{{/code}} 444 444 445 -(% style="line-height:1.38" %) 446 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: top// 397 +{{code}} 398 +dn: cn=ppolicy,ou=default,dc=digdash,dc=com 399 +objectClass: top 400 +objectClass: subentry 401 +objectClass: pwdPolicy 402 +cn: ppolicy 403 +pwdAttribute: userPassword 404 +pwdAllowUserChange: TRUE 405 +pwdCheckQuality: 1 406 +pwdExpireWarning: 600 407 +pwdFailureCountInterval: 30 408 +pwdGraceAuthNLimit: 5 409 +pwdInHistory: 5 410 +pwdLockout: TRUE 411 +pwdLockoutDuration: 900 412 +pwdMaxAge: 0 413 +pwdMaxFailure: 5 414 +pwdMinAge: 0 415 +pwdMustChange: FALSE 416 +pwdSafeModify: FALSE 417 +subtreeSpecification: {base "ou=users", specificationFilter "!(uid=admin)" } 418 +{{/code}} 447 447 448 -(% style="line-height:1.38" %) 449 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: subentry// 450 - 451 -(% style="line-height:1.38" %) 452 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: pwdPolicy// 453 - 454 -(% style="line-height:1.38" %) 455 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//cn: ppolicy// 456 - 457 -(% style="line-height:1.38" %) 458 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAttribute: userPassword// 459 - 460 -(% style="line-height:1.38" %) 461 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAllowUserChange: TRUE// 462 - 463 -(% style="line-height:1.38" %) 464 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdCheckQuality: 1// 465 - 466 -(% style="line-height:1.38" %) 467 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdExpireWarning: 600// 468 - 469 -(% style="line-height:1.38" %) 470 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdFailureCountInterval: 30// 471 - 472 -(% style="line-height:1.38" %) 473 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdGraceAuthNLimit: 5// 474 - 475 -(% style="line-height:1.38" %) 476 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdInHistory: 5// 477 - 478 -(% style="line-height:1.38" %) 479 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdLockout: TRUE// 480 - 481 -(% style="line-height:1.38" %) 482 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdLockoutDuration: 900// 483 - 484 -(% style="line-height:1.38" %) 485 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMaxAge: 0// 486 - 487 -(% style="line-height:1.38" %) 488 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMaxFailure: 5// 489 - 490 -(% style="line-height:1.38" %) 491 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMinAge: 0// 492 - 493 -(% style="line-height:1.38" %) 494 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMustChange: FALSE// 495 - 496 -(% style="line-height:1.38" %) 497 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdSafeModify: FALSE// 498 - 499 -(% style="line-height:1.38" %) 500 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//subtreeSpecification: {base "ou=users", specificationFilter "!(uid=admin)" }// 501 -))) 502 -))) 503 - 504 504 (% start="8" %) 505 -1. Set a second password policy for the admin using the “ppolicy-admin.ldif” file below:((( 506 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ppolicy-admin.ldif 421 +1. Set a second password policy for admin using the ‘ppolicy-admin.ldif’ file below: 507 507 508 - |(%style="background-color:black"%)(((509 - (%style="line-height:1.38"%)510 - (% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn:cn=ppolicy-admin,ou=default,dc=digdash,dc=com//423 +{{code language="shell"}} 424 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" ppolicy-admin.ldif 425 +{{/code}} 511 511 512 -(% style="line-height:1.38" %) 513 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: top// 427 +{{code}} 428 +dn: cn=ppolicy-admin,ou=default,dc=digdash,dc=com 429 +objectClass: top 430 +objectClass: subentry 431 +objectClass: pwdPolicy 432 +cn: ppolicy-admin 433 +pwdAttribute: userPassword 434 +pwdAllowUserChange: TRUE 435 +pwdCheckQuality: 1 436 +pwdFailureCountInterval: 30 437 +pwdGraceAuthNLimit: 5 438 +pwdInHistory: 5 439 +pwdLockout: FALSE 440 +pwdMaxAge: 0 441 +pwdMinAge: 0 442 +pwdMustChange: FALSE 443 +pwdSafeModify: FALSE 444 +subtreeSpecification: {base "ou=users", specificationFilter "(uid=admin)" } 445 +{{/code}} 514 514 515 -(% st yle="line-height:1.38" %)516 - (%style="color:#ffffff;font-family:Consolas,sans-serif;font-size:11pt; font-style:italic;font-variant:normal; font-weight:400; overflow-wrap:break-word;overflow:hidden;text-decoration:none;white-space:pre-wrap" %)//objectClass:subentry//447 +(% start="9" %) 448 +1. Change password policy to allow pre-encoded passwords (useful for restores in Digdash): 517 517 518 -(% style="line-height:1.38" %) 519 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: pwdPolicy// 450 +{{code language="shell"}} 451 +sudo /opt/opendj/bin/dsconfig set-password-policy-prop --policy-name "Default Password Policy" --set allow-pre-encoded-passwords:true --hostname localhost --trustAll --bindDN "cn=directory manager" --bindPassword "adminOpenDJ1" --no-prompt 452 +{{/code}} 520 520 521 -(% st yle="line-height:1.38" %)522 - (%style="color:#ffffff;font-family:Consolas,sans-serif;font-size:11pt;font-style:italic;font-variant:normal;font-weight:400; overflow-wrap:break-word;overflow:hidden;text-decoration:none;white-space:pre-wrap" %)//cn:ppolicy-admin//454 +(% start="10" %) 455 +1. Create an admin user for Digdash using the “create_user_admin.ldif” file below: 523 523 524 -(% style="line-height:1.38" %) 525 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAttribute: userPassword// 457 +{{code language="shell"}} 458 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" create_user_admin.ldif 459 +{{/code}} 526 526 527 -(% style="line-height:1.38" %) 528 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdAllowUserChange: TRUE// 461 +{{code}} 462 +dn: uid=admin,ou=default,dc=digdash,dc=com 463 +objectClass: shadowAccount 464 +objectClass: inetOrgPerson 465 +cn: Admin Domain Default 466 +sn: Default 467 +uid: admin_default 468 +{{/code}} 529 529 530 -(% style="line-height:1.38" %) 531 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdCheckQuality: 1// 532 - 533 -(% style="line-height:1.38" %) 534 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdFailureCountInterval: 30// 535 - 536 -(% style="line-height:1.38" %) 537 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdGraceAuthNLimit: 5// 538 - 539 -(% style="line-height:1.38" %) 540 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdInHistory: 5// 541 - 542 -(% style="line-height:1.38" %) 543 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdLockout: FALSE// 544 - 545 -(% style="line-height:1.38" %) 546 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMaxAge: 0// 547 - 548 -(% style="line-height:1.38" %) 549 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMinAge: 0// 550 - 551 -(% style="line-height:1.38" %) 552 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdMustChange: FALSE// 553 - 554 -(% style="line-height:1.38" %) 555 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//pwdSafeModify: FALSE// 556 - 557 -(% style="line-height:1.38" %) 558 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//subtreeSpecification: {base "ou=users", specificationFilter "(uid=admin)" }// 559 -))) 560 -))) 561 -1. Change the password policy to allow pre-encoded passwords (useful for restores in digdash) :((( 562 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)/opt/opendj/bin/dsconfig set-password-policy-prop ~-~-policy-name "Default Password Policy" ~-~-set allow-pre-encoded-passwords:true ~-~-hostname localhost ~-~-trustAll ~-~-bindDN "cn=directory manager" ~-~-bindPassword adminOpenDJ1 ~-~-no-prompt 563 -))) 564 -1. Create an admin user for digdash via the “create_user_admin.ldif” file below((( 565 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)/opt/opendj/bin/ldapmodify (% style="color:#ffffff" %)~-~-port 389 (% style="color:#ecf0f1" %)~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 create_user_admin.ldif 566 - 567 -|(% style="background-color:black" %)((( 568 -(% style="line-height:1.38" %) 569 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: uid=admin,ou=default,dc=digdash,dc=com// 570 - 571 -(% style="line-height:1.38" %) 572 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: shadowAccount// 573 - 574 -(% style="line-height:1.38" %) 575 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//objectClass: inetOrgPerson// 576 - 577 -(% style="line-height:1.38" %) 578 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//cn: Admin Domain Default// 579 - 580 -(% style="line-height:1.38" %) 581 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//sn: Default// 582 - 583 -(% style="line-height:1.38" %) 584 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//uid: admin_default// 585 -))) 586 -))) 587 - 588 588 (% start="11" %) 589 -1. Assign the admin user the necessary rights using the “add_admin_right.ldif” and “add_admin_right2.ldif” files below:((( 590 -|(% style="background-color:black" %)(% style="color:#ecf0f1" %)/opt/opendj/bin/ldapmodify (% style="color:#ffffff" %)~-~-port 389 (% style="color:#ecf0f1" %)~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 add_admin_right.ldif 471 +1. Assign the admin user the necessary rights using the “add_admin_right.ldif” and “add_admin_right2.ldif” files below: 591 591 592 -|(% style="background-color:black" %)((( 593 -(% style="color:#ffffff" %)dn: ou=default,dc=digdash,dc=com 473 +{{code language="shell"}} 474 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" add_admin_right.ldif 475 +{{/code}} 594 594 595 -(% style="color:#ffffff" %)changetype: modify 477 +{{code}} 478 +dn: ou=default,dc=digdash,dc=com 479 +changetype: modify 480 +add: aci 481 +aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow write on userpassword and shadowlastchange for admin"; allow(write) (userdn = "ldap:///uid=admin,ou=default,dc=digdash,dc=com");) 482 +aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow read,write on userpassword and shadowlastchange for auth users"; allow(read) (userdn = "ldap:///all");) 483 +aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow read on userpassword and shadowlastchange for anonymous"; allow(selfwrite) (userdn = "ldap:///anyone");) 484 +aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow write on * for admin"; allow(all) (userdn = "ldap:///uid=admin,ou=default,dc=digdash,dc=com");) 485 +aci: (target ="ldap:///ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow read on * for anonymous"; allow(read) (userdn = "ldap:///all");) 486 +{{/code}} 596 596 597 -(% style="color:#ffffff" %)add: aci 488 +{{code language="shell"}} 489 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" add_admin_right2.ldif 490 +{{/code}} 598 598 599 -(% style="color:#ffffff" %)aci: (target ="ldap:~/~//ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow write on userpassword and shadowlastchange for admin"; allow(write) (userdn = "ldap:~/~//uid=admin,ou=default,dc=digdash,dc=com"){{{;)}}} 492 +{{code}} 493 +dn: uid=admin,ou=default,dc=digdash,dc=com 494 +changetype: modify 495 +add: ds-privilege-name 496 +ds-privilege-name: config-read 497 +ds-privilege-name: password-reset 498 +{{/code}} 600 600 601 -(% style="color:#ffffff" %)aci: (target ="ldap:~/~//ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow read,write on userpassword and shadowlastchange for auth users"; allow(read) (userdn = "ldap:~/~//all"){{{;)}}} 500 +(% start="12" %) 501 +1. Generate an administrator password and remember it for later: 602 602 503 +{{code language="shell"}} 504 +sudo /opt/opendj/bin/ldappasswordmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --authzID "u:admin" 505 +{{/code}} 603 603 604 -(% style="color:#ffffff" %)aci: (target ="ldap:~/~//ou=default,dc=digdash,dc=com")(targetattr = "userpassword || shadowlastchange")(version 3.0; acl "allow read on userpassword and shadowlastchange for anonymous"; allow(selfwrite) (userdn = "ldap:~/~//anyone"){{{;)}}} 507 +(% class="box infomessage" %) 508 +((( 509 +💡 If you want to set your own password for the admin user, you need to use a variation of the previous command: 605 605 606 - 607 -(% style="color:#ffffff" %)aci: (target ="ldap:~/~//ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow write on * for admin"; allow(all) (userdn = "ldap:~/~//uid=admin,ou=default,dc=digdash,dc=com"){{{;)}}} 608 - 609 -(% style="color:#ffffff" %)aci: (target ="ldap:~/~//ou=default,dc=digdash,dc=com")(targetattr = "*")(version 3.0; acl "allow read on * for anonymous"; allow(read) (userdn = "ldap:~/~//all"){{{;)}}} 511 +{{code language="shell"}} 512 +sudo /opt/opendj/bin/ldappasswordmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" --authzID "u:admin" --newPassword "mdpAdmin" 513 +{{/code}} 610 610 ))) 611 611 612 -|(% style="background-color:black" %)(% style="color:#ffffff" %)/opt/opendj/bin/ldapmodify ~-~-port 389 ~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 add_admin_right2.ldif 613 - 614 -|(% style="background-color:black" %)((( 615 -(% style="line-height:1.38" %) 616 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: uid=admin,ou=default,dc=digdash,dc=com// 617 - 618 -(% style="line-height:1.38" %) 619 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//changetype: modify// 620 - 621 -(% style="line-height:1.38" %) 622 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//add: ds-privilege-name// 623 - 624 -(% style="line-height:1.38" %) 625 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ds-privilege-name: config-read// 626 - 627 -(% style="line-height:1.38" %) 628 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ds-privilege-name: password-reset// 629 -))) 630 -))) 631 - 632 -(% start="12" %) 633 -1. Generate a password for the administrator and remember it for later:((( 634 -|(% style="background-color:black" %)(% style="background-color:#000000; color:#ecf0f1" %)/opt/opendj/bin/ldappasswordmodify (% style="color:#ffffff" %)~-~-port 389 (% style="background-color:#000000; color:#ecf0f1" %)~-~-bindDN "cn=Directory Manager" ~-~-bindPassword adminOpenDJ1 ~-~-authzID "u:admin" 635 -))) 636 - 637 637 (% style="line-height:1.38; text-indent:-14.173228346456689pt; margin-top:13px; margin-bottom:13px; padding:0pt 0pt 0pt 14.173228346456689pt" %) 638 638 == Enabling automatic service start on startup == 639 639 519 +1. Create the opendj.service file: 640 640 641 - 1. Create theopendj.servicefile:(((642 - |(%style="background-color:black"%)(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal;font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)sudo vi/etc/systemd/system/opendj.service643 - )))521 +{{code language="shell"}} 522 +sudo vi /etc/systemd/system/opendj.service 523 +{{/code}} 644 644 645 645 (% start="2" %) 646 -1. Paste the following lines there:((( 647 -|(% style="background-color:black" %)((( 648 -(% style="line-height:1.38" %) 649 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)[Unit] 526 +1. And paste the following lines: 650 650 651 - (% style="line-height:1.38" %)652 - (% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Description=OpenDJ Server Daemon528 +{{code}} 529 +[Unit] 653 653 654 -(% style="line-height:1.38" %) 655 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Wants=network-online.target 531 +Description=OpenDJ Server Daemon 656 656 657 -(% style="line-height:1.38" %) 658 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)After=network-online.target 533 +Wants=network-online.target 659 659 660 -(% style="line-height:1.38" %) 661 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Conflicts=shutdown.target 535 +After=network-online.target 662 662 663 - (% style="background-color:#000000" %) (% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word;overflow:hidden;text-decoration:none; white-space:pre-wrap" %)[Service]537 +Conflicts=shutdown.target 664 664 665 -(% style="line-height:1.38" %) 666 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Type=simple 539 + [Service] 667 667 668 -(% style="line-height:1.38" %) 669 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Restart=no 541 +Type=simple 670 670 671 -(% style="line-height:1.38" %) 672 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)TimeoutSec=5min 543 +Restart=no 673 673 674 -(% style="line-height:1.38" %) 675 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)IgnoreSIGPIPE=no 545 +TimeoutSec=5min 676 676 677 -(% style="line-height:1.38" %) 678 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)KillMode=process 547 +IgnoreSIGPIPE=no 679 679 680 -(% style="line-height:1.38" %) 681 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)GuessMainPID=no 549 +KillMode=process 682 682 683 -(% style="line-height:1.38" %) 684 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)RemainAfterExit=yes 551 +GuessMainPID=no 685 685 686 -(% style="line-height:1.38" %) 687 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)ExecStart=/opt/opendj/bin/start-ds ~-~-quiet 553 +RemainAfterExit=yes 688 688 689 -(% style="line-height:1.38" %) 690 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)ExecStop=/opt/opendj/bin/stop-ds ~-~-quiet 555 +ExecStart=/opt/opendj/bin/start-ds --quiet 691 691 692 - (% style="background-color:#000000" %) (% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word;overflow:hidden; text-decoration:none; white-space:pre-wrap" %)[Install]557 +ExecStop=/opt/opendj/bin/stop-ds --quiet 693 693 694 -(% style="line-height:1.38" %) 695 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)WantedBy=multi-user.target 696 -))) 697 -))) 559 + [Install] 698 698 561 +WantedBy=multi-user.target 562 +{{/code}} 563 + 699 699 (% start="3" %) 700 -1. Then type the following commands((( 701 -|(% style="background-color:black" %)((( 702 -(% style="line-height:1.38" %) 703 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)systemctl daemon-reload 565 +1. Then type the following commands: 704 704 705 - (%style="line-height:1.38"%)706 - (%style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal;font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)systemctlenable ~-~-now opendj567 +{{code language="shell"}} 568 +systemctl daemon-reload 707 707 708 -(% style="line-height:1.38" %) 709 -(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)systemctl status opendj 710 -))) 711 -))) 570 +systemctl enable --now opendj 712 712 713 -== Fonction utile == 572 +systemctl status opendj 573 +{{/code}} 714 714 715 -L'opération ci-dessous ne fait pas partie de l'installation. 716 -Il peut néanmoins être utile de la connaître pour une utilisation ultérieure. 575 +== Useful option == 717 717 718 -=== Étendre la limite pour les recherches LDAP === 577 +The operation below is not part of the installation. 578 +However, it may be useful to know it for later use. 719 719 720 - Étendre la limitederechercheduLDAPà plusde1000 utilisateurs avecle fichier “extend_search_limit.ldif”ci-dessous580 +=== Extending the limit for LDAP searches === 721 721 722 - |(% style="background-color:black"%)(% style="background-color:#000000; color:#ffffff; font-family:Consolas,sans-serif;font-size:11pt; font-style:italic;font-variant:normal;font-weight:400; text-decoration:none; white-space:pre-wrap" %)///opt/opendj/bin/ldapmodify//(% style="color:#ffffff"%)~-~-port389 (%style="background-color:#000000;color:#ffffff; font-family:Consolas,sans-serif;font-size:11pt;font-style:italic;font-variant:normal;font-weight:400;text-decoration:none;white-space:pre-wrap"%)//~-~-bindDN "cn=Directory Manager"~-~-bindPassword adminOpenDJ1 extend_search_limit.ldif//582 +It is possible to extend the LDAP search limit to more than 1000 users with the “extend_search_limit.ldif” file below. 723 723 724 - |(%style="background-color:black"%)(((725 - (%style="line-height:1.38"%)726 - (% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//dn: uid=admin,ou=default,dc=digdash,dc=com//584 +{{code language="shell"}} 585 +sudo /opt/opendj/bin/ldapmodify --port 389 --bindDN "cn=Directory Manager" --bindPassword "adminOpenDJ1" extend_search_limit.ldif 586 +{{/code}} 727 727 728 -(% style="line-height:1.38" %) 729 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//changetype: modify// 588 +{{code}} 589 +dn: uid=admin,ou=default,dc=digdash,dc=com 590 +changetype: modify 591 +add: ds-rlim-size-limit 592 +ds-rlim-size-limit: 10000 593 +{{/code}} 730 730 731 -(% style="line-height:1.38" %) 732 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//add: ds-rlim-size-limit// 595 +(% class="wikigeneratedid" id="H" style="line-height: 1.2;" %) 733 733 734 -(% style="line-height:1.38" %) 735 -(% style="color:#ffffff; font-family:Consolas,sans-serif; font-size:11pt; font-style:italic; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)//ds-rlim-size-limit: 10000// 736 -))) 737 737 738 -= MariaDB ( Préconisé){{id name="DB_ubuntu"/}} =598 += MariaDB (Recommended){{id name="DB_ubuntu"/}} = 739 739 740 - La basede donnéesMariaDBvaserviràstockerlesélémentssuivants:Commentaires,données d'auditetformulairesdesaisies.600 +The MariaDB database will be used to store the following elements: comments, audit data and data entry. 741 741 742 - Cettebaseestplus pérennequ'unebaseH2c'estpourquoinouspréconisonssonutilisation.Sivouspossédezdéjàune basede données sur laquelleDigdashpeut écrireetlirealorspassezàl'étapedeconfiguration.602 +This database is more durable than an H2 database, that is why we recommend its use. If you already have a database that Digdash can write to and read from then proceed to the configuration step. 743 743 744 - Cela fonctionne aussi avecMysqlouPostgresql.604 +Mysql and Postgresql are also compatible. 745 745 746 746 == Installation == 747 747 ... ... @@ -750,28 +750,28 @@ 750 750 {{/code}} 751 751 752 752 {{code language="shell"}} 753 -# Démarragedemariadb613 +#start mariadb 754 754 sudo systemctl start mariadb 755 -# Arrêtdemariadb615 +#Stop mariadb 756 756 sudo systemctl stop mariadb 757 -#Reload pourpriseencompte de modificationde configuration617 +#Reload to take into account the configuration changes 758 758 sudo systemctl reload mariadb 759 759 sudo systemctl force-reload mariadb 760 -# Connaîtrelaversion620 +#Display the version 761 761 mariadb --version 762 762 763 763 {{/code}} 764 764 765 765 (% class="wikigeneratedid" %) 766 -Lanc ermysql_secure_installation,celava permettrede sécuriser l'installation626 +Launch mysql_secure_installation. This will secure the installation. 767 767 768 768 {{code language="shell"}} 769 769 sudo mysql_secure_installation 770 770 771 -# Répondez oui àtouteslesétapes631 +# Enter yes at all steps 772 772 {{/code}} 773 773 774 -== Activationdu lancement automatiqueduservice audémarrage==634 +== Enabling automatic service start on startup == 775 775 776 776 {{code language="shell"}} 777 777 sudo systemctl enable mariadb ... ... @@ -778,37 +778,36 @@ 778 778 779 779 {{/code}} 780 780 781 -== Configurationcôté base de données==641 +== Database configuration == 782 782 783 - Nousallonscréer une basepour chaquedomaineetchaquewebapps (par exemple prod_ddauditetdev_ddauditetainsidesuite)643 +We will create a base for each domain and each webapps (for example prod_ddaudit and dev_ddaudit and so on) 784 784 785 - Dansl'exempleci dessous,nousallonsconsidérerqu'il n'existequ'unenvironnement'default'.645 +In the example below, we will consider that there is only one 'default' environment. 786 786 787 787 {{code language="shell"}} 788 -# Lancer mariadb648 +# Start mariadb 789 789 sudo mariadb -u root -p 790 790 791 -# Cr éertouteslesbases de données nécessaires domaine_module.651 +# Create all necessary databases domain_module. 792 792 CREATE DATABASE default_ddaudit; 793 793 CREATE DATABASE default_comment; 794 794 CREATE DATABASE default_ddentry; 795 795 796 -# Cr éerunuserpour chaquebase de données domaine_user_module.Lemot depasseestunnouveaumot depasseàcréer.656 +# Create a user for each database domaine_user_module. The password is a new one to create. 797 797 CREATE USER 'default_user_ddaudit'@'localhost' IDENTIFIED BY 'mynewpassword'; 798 798 CREATE USER 'default_user_comment'@'localhost' IDENTIFIED BY 'mynewpassword'; 799 799 CREATE USER 'default_user_ddentry'@'localhost' IDENTIFIED BY 'mynewpassword'; 800 800 801 -# A ttribuerles droitsauxutilisateurssur lesbonnesbases661 +# Assign rights on the databases to the user 802 802 GRANT ALL PRIVILEGES ON default_comment.* TO 'default_user_comment'@'localhost'; 803 803 GRANT ALL PRIVILEGES ON default_ddaudit.* TO 'default_user_ddaudit'@'localhost'; 804 804 GRANT ALL PRIVILEGES ON default_ddentry.* TO 'default_user_ddentry'@'localhost'; 805 805 {{/code}} 806 806 667 += NGINX (Optional) = 807 807 808 - =NGINX (Optionnel)=669 +Nginx is used as reverse proxy. 809 809 810 -Nous utilisons Nginx comme reverse proxy. 811 - 812 812 == Installation == 813 813 814 814 {{code language="shell"}} ... ... @@ -815,7 +815,7 @@ 815 815 sudo apt install nginx 816 816 {{/code}} 817 817 818 -== Activationdu lancement automatiqueduservice audémarrage==677 +== Enabling automatic service start on startup == 819 819 820 820 {{code language="shell"}} 821 821 sudo systemctl enable nginx ... ... @@ -823,18 +823,19 @@ 823 823 824 824 == Configuration == 825 825 826 -Cr éer lefichierdeconfigurationportantle nomdevotremachine ou de votreenvironnement.Danscet exemple,onutilise 001-digdash.685 +Create the configuration file with the name of your machine or environment. In this example, we use 001-digdash. 827 827 828 - Dansledossier/etc/nginx :687 +In the /etc/nginx folder: 829 829 830 830 {{code language="shell"}} 831 -# Cr éer lefichierdeconf690 +# Create the conf file 832 832 sudo vi /etc/nginx/sites-available/001-digdash.conf 833 833 {{/code}} 834 834 835 835 {{code language="shell"}} 836 -# Ajouter le contenu suivant à l'intérieur. 837 -# Remplacer .mondomaine.com pour server et les chemins Certificate(s) and private key, par vos informations. 695 +# Add the following content inside. 696 +# Replace .mydomain.com for server and paths 697 +Certificate(s) and private key, par vos informations. 838 838 upstream backend_tomcat{ 839 839 least_conn; 840 840 server localhost:8080 fail_timeout=0; ... ... @@ -882,13 +882,13 @@ 882 882 } 883 883 {{/code}} 884 884 885 - Puiscréer un liensymboliquedanssiteenabled745 +Then create a symbolic link in sites-enabled 886 886 887 887 {{code language="shell"}} 888 888 sudo ln -s /etc/nginx/sites-available/001-digdash.conf /etc/nginx/sites-enabled/001-digdash.conf 889 889 {{/code}} 890 890 891 -Cr éer lefichierdigdash_ssl_params contenant la politiquedesecurité.751 +Create the digdash_ssl_params file containing the security policy: 892 892 893 893 {{code language="shell"}} 894 894 sudo vi digdash_ssl_params ... ... @@ -917,11 +917,11 @@ 917 917 add_header Strict-Transport-Security 'max-age=31536000; includeSubDomains; preload' always; 918 918 {{/code}} 919 919 920 -= (% id="cke_bm_868S" style="display:none" %) (%%)Configur ation DigDash aprèsinstallation =780 += (% id="cke_bm_868S" style="display:none" %) (%%)Configuring DigDash after installation = 921 921 922 -== LancementdeDigdash ==782 +== Starting Digdash == 923 923 924 -1. Re démarrerleserviceTomcat.784 +1. Restart Tomcat service. 925 925 926 926 {{code language="shell"}} 927 927 sudo service tomcat9 restart ... ... @@ -928,81 +928,81 @@ 928 928 {{/code}} 929 929 930 930 (% start="2" %) 931 -1. Vérifierle déploiementdes war dansledossier d’installation home/digdash/webapps/default.932 -1. Acc éderàDigDashsurl’adressesuivante: [[__http:~~/~~/localhost:8080/adminconsole__>>url:http://localhost:8080/adminconsole]].933 - Le login/mot depasseseraadmin/admin.791 +1. Check the war deployment in the installation folder home/digdash/webapps/default. 792 +1. Access DigDash homepage at the following address : [[http:~~/~~/localhost:8080/adminconsole>>url:http://localhost:8080/adminconsole]] 793 +The login/password is admin/admin. 934 934 935 - [[image:Homepage2023R2.png||alt="Page_accueil"]]795 +== Connecting Digdash to the installed OpenDJ server == 936 936 937 - == BranchementdeDigdashauserveurOpenDJinstallé==797 +Open [[http:~~/~~/localhost:8080/adminconsole/>>url:http://localhost:8080/adminconsole/]], **Configuration -> Server settings -> Servers -> LDAP Server**. 938 938 939 - Aller dans **Configuration -> Paramètres serveur-> Serveurs -> LDAP**. 799 +* Port: 389 800 +* User: uid=admin, ou=default,dc=digdash,dc=com 801 +* Password: OpenDJ admin password 940 940 941 -* Port : 389 942 -* Utilisateur : uid=admin, ou=default,dc=digdash,dc=com 943 -* Mot de passe : mot de passe admin de OpenDJ 803 +[[image:LDAPserver_ok.png||alt="LDAP server"]] 944 944 945 - [[image:1675171192455-197.png]]805 +Then click the **LDAP Queries** button and enter "**ou=default**" in the **Domain Tree** field for all the fields to be automatically filled as below. 946 946 947 - Cliquer ensuite sur **RequêtesLDAP**,et entrer "**ou=default**"dans le champ **Arbredu domaine** pourqueles champs soient automatiquementrenseignés commeci-dessous.807 +[[image:LDAPqueries_ok.png||alt="LDAP queries"]] 948 948 949 - [[image:1675171204379-473.png]]809 +== Changing the supervisor password and creating the LDAP account == 950 950 951 -== Modificationdu motdepasse superviseuret créationducompte LDAP==811 +=== Changing the supervisor password === 952 952 953 - === Modificationdumot de passesuperviseur===813 +Open **Configuration -> Server settings > Servers -> Enterprise Server **and enter a new password in the **Supervisor Password** field. 954 954 955 - Aller dans **Configuration -> Paramètres serveur > Serveurs -> ServeurEnterprise**et entrer un nouveau mot depasse dans le champ **Motde passe duSuperviseur**.815 +[[image:EnterpriseServer.png||alt="Supervisor password"]] 956 956 957 - [[image:Serveur_enterprise.png||alt="Serveurenterprise"]]817 +=== Creating the LDAP account === 958 958 959 -=== Création du compte LDAP === 819 +1. Open **Configuration -> User management -> Users**. 820 +1. Create a new admin user and assign him all roles and authorizations groups. 821 +1. In the **Password** field, enter the new supervisor password defined above. 960 960 961 -1. Aller dans **Configuration -> Gestion des utilisateurs -> Utilisateurs**. 962 -1. Créer un nouvel utilisateur admin et lui attribuer tous les rôles et groupes d'autorisation. 963 -1. Dans le champ **Mot de passe**, entrer le nouveau mot de passe du superviseur défini ci-dessus. 823 +[[image:User_password.png||alt="User password"]] 964 964 965 - [[image:MdP_LDAP.png||alt="CompteLDAP"]]825 +== Database configuration == 966 966 967 -== Configurationdesbasesde données==827 +=== Audit data database === 968 968 969 - ===Base dedonnéesDonnéesd'audit===829 +Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password. 970 970 971 -(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %) 972 -Aller dans **Configuration -> Paramètres serveur -> Base de données -> Données d'audit** et renseigner ici l’URL, l’utilisateur et le mot de passe. 973 - 974 -(% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %) 975 975 **URL **: //jdbc:mariadb:~/~/localhost:3306/default_ddaudit// 976 976 977 - Cettesolutionpermetde sécuriserl’accèsà la basede donnéesd'audit.833 +This solution makes it possible to secure access to the audit database. 978 978 979 -[[image: Données_audit.png||alt="Données_audit"]]835 +[[image:Audit_data.png||alt="Audit data"]] 980 980 981 -=== Base de donnéesCommentaires ===837 +=== Comments database === 982 982 983 -(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; margin-top: 13px; margin-bottom: 13px; text-align: justify;" %) 984 -Aller dans **Configuration -> Paramètres serveur -> Base de données -> Commentaires** et renseigner ici l’URL, l’utilisateur et le mot de passe. 839 +Open **Configuration -> Server settings -> Databases -> Audit data **and enter the URL, user and password. 985 985 986 -(% class="wikigeneratedid" style="line-height: 1.2; margin-top: 13px; margin-bottom: 13px; text-align: justify;" %) 987 -**URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment// 841 +**URL** ~:// jdbc:mariadb:~/~/localhost:3306/default_comment// 988 988 989 - Cettesolutionpermetde sécuriserl’accèsà la basede donnéesde commentaires.843 +This solution makes it possible to secure access to the comment database. 990 990 991 -[[image:Comment aires.png||alt="Commentaires"]]845 +[[image:Comments.png||alt="Comments"]] 992 992 993 993 (% style="line-height: 1.2; text-indent: 0.153543pt; text-align: justify;" %) 994 -=== BasededonnéesSaisiede données===848 +=== Data entry database === 995 995 996 -(% class="wikigeneratedid" id="HAllerdansConfiguration-3EParamE8tresserveur-3ECommentairesetrenseignericil2019URL2Cl2019utilisateuretlemotdepasse." style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %) 997 -Aller dans **Configuration -> Paramètres serveur -> Base de données -> Saisie des données**. 850 +Open **Configuration -> Server settings -> Databases -> Data entry **and enter the URL, user and password. 998 998 999 -(% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %) 1000 -Cocher la case **Activer la saisir de données** et sélectionner une base de données dans la liste déroulante. 852 +Select the **Enable data entry** checkbox and select a database in the drop-down list below. 1001 1001 1002 1002 (% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %) 1003 -[[image: 1698407220646-676.png||alt="Saisiedonnées"]]855 +[[image:Data_entry.png]] 1004 1004 1005 1005 (% class="wikigeneratedid" style="line-height: 1.2; text-align: justify; margin-top: 13px; margin-bottom: 13px;" %) 1006 -Il faut, au préalable, avoir créé une connexion à la base de données depuis le **Gestionnaire des connexions aux de données** dans le Studio. Consultez la page [[Gestionnaire des connexions aux bases de données>>doc:dev:Digdash.user_guide.studio.managers.dbconnections.WebHome]] pour plus de détails. 1007 -Entrer default.user.ddentry pour l'utilisateur et le mot de passe défini à l'étape précédente. 1008 -Le nom défini dans le champ **Nom de connexion **est celui qui apparaîtra dans la liste déroulante de sélection de la base de données. 858 +You must first have created a connection to the database from the Data connection manager in the Studio. 859 +Enter default.user.ddentry for the user and password defined in the previous step. 860 +The name defined in the **Login Name** field is the one that will appear in the database selection drop-down list. 861 + 862 +== DigDash Services == 863 + 864 +Open the Server status page : [[__http:~~/~~/localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi__>>url:http://localhost:8080/ddenterpriseapi/serverstatus?adminDomain=adminconsole&serverDomain=ddenterpriseapi]] 865 + 866 +Check that the DigDash services are activated and that the maximum memory is well adapted to the capacity of the server. You must leave at least 4 GB for the system. 867 + 868 +[[image:Server_status.png||alt="Server status"]]