To configure the Data Steward, you must first make sure that you have created a user with Data Steward privileges. To create a Data Steward, please follow the instructions here: SHRINE 4.1.0 Chapter 9.1 - Setting Up the Data Steward User
Find the steward section in shrine.conf . This section governs how the data steward application behaves, including its ability to send audit emails to the Data Steward. Set valid email addresses in the 'From' and 'To' fields. Set the externalStewardBaseUrl to the URL your Data Steward should use for the data steward application. (The email contains a link to help easily start the audits.)
shrine { ... steward { createTopicsMode = Approved //the default is Pending - the most secure - but most sites use Approved emailDataSteward { //provide the email address of the shrine node system admin, to handle bounces and invalid addresses from = "shrine-admin@example.com" //provide the email address of the shrine node system admin, to handle bounces and invalid addresses to = "shrine-steward@example.com" //provide the externally-reachable URL for the data steward externalStewardBaseUrl = ${shrine.shrineHubBaseUrl}/shrine-api/shrine-steward } } // end steward ... }
SHRINE by default assumes it can send mail via smtp on localhost port 25. However, if your tomcat server cannot easily send email you may need to add an email{} section inside of the shrine{} section in shrine.conf. SHRINE sends emails from postfix on port 25 by default. SHRINE uses javaxmail internally. Any valid javaxmail configuration values should be supported by shrine.conf. Here is an example that uses AWS SES:
shrine { ... email { //add javax mail properties from https://www.tutorialspoint.com/javamail_api/javamail_api_smtp_servers.htm here javaxmail { mail { smtp { //for postfix on localhost //host = localhost //port = 25 //for AWS SES - See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-using-smtp-java.html //comment out if you want to just use postfix over port 25 host = email-smtp.us-east-1.amazonaws.com port = 25 transport.protocol = smtps auth = true starttls.enable = true starttls.required = true } } }//end javaxmail section //Must be set for AWS SES. See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-using-smtp-java.html authenticator { username = yourSESUsername } } //end email section ... }
shrine.email.javaxmail.authenticator.password = yourSESPassword