Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

By default, EmpowerID is configured to use SMTP as the provider for email delivery. However, SMTP is not the only provider option. You can elect to use SendGrid (requires a SendGrid account with an API key), Exchange Web Services (on-premise or Office 365), or both SMTP and Exchange Web Services (EWS). If you choose to use more than one provider, you order the precedence by setting the priority for each. The provider with the lowest priority has the higher precedence. By default, SMTP has precedence. You can change this at any time.

You can configure EmpowerID to process emails differently, depending on your scenario. These scenarios include the following:

  • Simple SMTP relay – In this scenario, you specify the SMTP server that EmpowerID uses to send automated emails on behalf of the system and the default from address for all EmpowerID notifications. Examples of these types of emails include welcoming emails sent to new employees, emails sent to users when their passwords are reset by the help desk,

...

  • pending password expiration notifications, etc.

  • Authenticated SMTP Delivery – In this scenario, you specify an account that EmpowerID should use to connect to the SMTP server. This account must have a password that is vaulted in EmpowerID and becomes the default From address used for any automated emails sent on behalf of the system. When configuring for authenticated SMTP delivery, you have the option to specify whether to use SSL, TLS, and the port used for TLS.

  • Exchange Web Services (EWS) – In this scenario, you specify the account that EmpowerID should use to connect to EWS, as well as the URL to the EWS server. As with configuring EmpowerID for authenticated SMTP delivery, you need to vault the password for the user account.

  • SendGrid – In this scenario, you specify EmpowerID use SendGrid to send automated emails on behalf of the system. To use SendGrid, you need to have a SendGrid account with an API key and set up domain authentication in SendGrid to allow SendGrid to send emails originating from EmpowerID. Please see SendGrid’s documentation for further information on configuring SendGrid before selecting SendGrid for sending emails in EmpowerID.

  • Email approvals – In this scenario, you configure EmpowerID to give resource owners and other delegated approvers the ability to respond to Access Requests from their email clients, apart from interacting directly with the request in the EmpowerID Web interface. This allows users to respond to requests when away from their desks. To do so, they simply reply to the email with "Approved" or "Rejected." EmpowerID reads the response and submits the decision.

...

titleSMTP Relay

...

Note

  • When configuring EmpowerID for authenticated SMTP, the mailbox selected for reading and processing emails takes precedence over the setting entered in the SMTP From Address setting.

  • If you are using a mail delivery system other than Exchange that supports SMTP, then you need to create a tracking-only account store and add an account with the appropriate credentials, as well as a user principal name, for that system to that account store. You then vault the password for that user account.

Configure for Simple SMTP Relay

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and select Email Settings.

  2. Select SMTP from the Email Delivery Mode drop-down.

    Image Added

  3. In the SMTP Mail Delivery Settings pane, enter the following information:

    • SMTP From Address — This specifies the default From address the system should use when sending automated emails to your user.

    • SMTP Server DNS — This specifies the DNS or IP address of the SMTP server in your environment.

  4. Save your changes.

...

Configure for Authenticated SMTP

...

Relay

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and select Email Settings.

  2. Select SMTP from the Email Delivery Mode drop-down.

    Image Added

  3. In the SMTP Mail Delivery Settings pane, enter the following information:

    • Account with Vaulted Password for Authenticated SMTP

...

    •  – Select the user account to be used by EmpowerID to authenticate to the SMTP server and

...

    • send automated responses on behalf of the system. This account must have a password that is vaulted in EmpowerID. If the account does not have a password that is vaulted, please see How to Vault Account Passwords below and then return to complete the setup.

    • SMTP From

...

    • Address – This specifies the default From address the system should use when sending automated emails to your user.

    • SMTP Server DNS

...

    •  – This specifies the DNS or IP address of the SMTP server in your environment.

  1. Save your changes.

Note

  • When configuring EmpowerID for authenticated SMTP, the mailbox selected for reading and processing emails takes precedence over the setting entered in the SMTP From Address setting.

  • If you are using a mail delivery system other than Exchange that supports SMTP, then you need to create a tracking-only account store and add an account with the appropriate credentials, as well as a user principal name, for that system to that account store. You then vault the password for that user account.

  1. Next, if the user account to be used by EmpowerID to authenticate to the SMTP server does not have a password that is vaulted in EmpowerID, do the following to vault it:

    1. Expand Identity Administration on the navbar and click User Accounts to navigate to the Find Account page.

    2. Click the Edit Vaulted Account Password action.

      Image Added

    3. Search for the desired user account, click the record to select it, and then click Submit.

      Image Added

    4. In the Service Account Credentials form that opens, do the following:

      • Click Encryption Certificate and select a certificate for encrypting the password.

      • Enter the password in the Password and Confirm Password fields

      • Click Submit.

        Image Added

Configure for Office 365 / Exchange EWS

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and select Email Settings.

  2. Select Exchange EWS from the Email Delivery Mode drop-down.

    Image Added

  3. On the Email Settings page, edit the following settings:

    • Office 365 / Exchange Mailbox for Send and

...

    • Receive – This specifies the user account EmpowerID uses to authenticate to the EWS server as well as to send automated emails on behalf of the system. This account needs to have its password vaulted in EmpowerID.

    • Office 365 / Exchange Web Service

...

    • URL – This specifies the URL to the EWS server. If you are using Office 365, the value of the URL should be https://outlook.office365.com/EWS/Exchange.asmx.

...

    • Image Added

  1. Click Save.

...

  1. Next, if the user account to be used by EmpowerID to authenticate to the server does not have a password that is vaulted in EmpowerID, do the following to vault it:

    1. Expand Identity Administration on the navbar and click User Accounts to navigate to the Find Account page.

    2. Click the Edit Vaulted Account Password action.

      Image Added

    3. Search for the desired user account, click the record to select it, and then click Submit.

      Image Added

    4. In the Service Account Credentials form that opens, do the following:

      • Click Encryption Certificate and select a certificate for encrypting the password.

      • Enter the password in the Password and Confirm Password fields

      • Click Submit.

        Image Added

Configure for SendGrid

Info

Prerequisites

In order to use SendGrid as the Email provider, you need to have a SendGrid account with an API key and set up domain authentication in SendGrid to allow SendGrid to send emails originating from EmpowerID. Please see SendGrid’s documentation for further information.

After setting up SendGrid as outlined by their documentation, you can configure SendGrid as the Email provider in EmpowerID by doing the following:

  1. On the navbar, expand Infrastructure Admin > EmpowerID Servers and Settings and select Email Settings.

  2. Enter the following information in the Email Settings form:

    1. Email Delivery Mode – SendGrid

    2. SendGrid API Key – Your SendGrid API key

...

    1. Image Added

  1. Click Save.

...

Configure Email Approvals

Note

For EmpowerID to process email approvals, the task or operation being approved or rejected must have the EnableBulkApproval set to true. This is set in Workflow Studio.

If you are using SMTP, follow the procedure outlined in

...

On the Email settings page, select Enable Approve by Email Reply.

...

...

Click Save.

...

titleHow To Vault Account Passwords

...

On the navbar, expand Privileged Access and select Shared Credentials.

Select the All Shared Credentials tab and then click the Add button.

...

 

...

Enter a name for the shared credential in the Name and Display Name fields.

...

Click the Shared Credential Policy drop-down and select the appropriate one to link to the credentials. Here are the default options for non-computer credentials:

  • Non-Computer Creds - Multi-Check-Out - No Password Reset — Select this policy to create credentials for an account where more than one check out is allowed and you do not want EmpowerID to reset the password when a user checks in the credentials.

  • Non-Computer Creds - No Approval, No Multi Check-Out with Password Reset — Select this policy to create credentials for an account where more than one check out is not allowed, no approval is required, and you want EmpowerID to reset the password when a user checks in the credentials.

  • Non-Computer Creds - No Multi-Check-Out with Password Reset — Select this policy to create credentials for an account where more than one check out is not allowed and you want EmpowerID to reset the password when a user checks in the credentials. Please note that this policy type is only valid for use with user accounts with passwords that have been vaulted in EmpowerID. The user account must belong to a domain or account store that has been inventoried by EmpowerID.

  • Service Account with Scheduled Password Reset — Select this policy for credentials for a Windows Service account or IIS App pool identity.
    When you select this policy, EmpowerID resets the password against all Windows servers in your environment that have Windows Services or App Pools. Please note that this policy type is only valid for use with service accounts with passwords that have been vaulted in EmpowerID. The service account must belong to a domain or account store that has been inventoried by EmpowerID.

...

Underneath Location, click Select a Location, then select a location for the credential and click Save.

...

 

...

Enter a description in the Description field.

...

In the User Name field, enter the user name for the account you are vaulting.

...

In the Password field, enter the password for the account you are vaulting.

...

Optionally, enter any notes in the Notes field.

...

Select Enabled.

...

Click Save.

...

If you have not yet entered your master password for this session, EmpowerID prompts you to do so. Enter your master password and click OK.

...

 

...

If you have not yet created a master password for yourself, EmpowerID prompts you to do so. Enter a password in the Password and Confirm Password fields and click OK.

...

 

...

the Authenticated SMTP Delivery section, including vaulting a user account; otherwise, following the procedure outlined in the EWS section. After completing those steps, do the below steps.

  1. On the navbar, expand Infrastructure Admin EmpowerID Servers and Settings and select

...

  1. EmpowerID System Settings.

  2. Search for EmailApprovalbyEmailEnabled and click the Edit (blue star) button for the setting.

    Image Added

  3. Set the Value to True and click Save.

    Image Added

Insert excerpt
IL:External Stylesheet
IL:External Stylesheet
nopaneltrue

Div
stylefloat: left; position: fixed;

IN THIS ARTICLE

Table of Contents
maxLevel4
minLevel2
stylenone
printablefalse