ArcGIS Enterprise

What's new in ArcGIS Enterprise 10.8.1: Emails!

Introducing emails in 2020?!

One of the new capabilities in ArcGIS Enterprise 10.8.1 is the ability to send out emails. Whether you are asking yourself “what?” or perhaps even rejoicing with a “finally!”  – rest assured, this blog is for you.

The 10.8.1 release of the ArcGIS Enterprise portal, includes the ability to configure your Enterprise portal to send automatic email notifications by integrating with your organization’s SMTP server. This will send out emails when:

    1. A member in your organization forgets their password. This new email workflow will send that member a temporary password reset link that they can use to reset their password after answering a security question.
    2. A change is made to the password policy. In this case an email will be sent to the designated  administrative contacts with details of the new password policy.
    3. A user type, licensed app, or organization capability in your ArcGIS Enterprise portal license file is approaching expiration.  An email will be sent to the organization’s administrative contacts 90 days, 60 days, 30 days, 3 days, 2 days, and 1 day before the expiration date. This ensures you’re given plenty of time to reauthorize your ArcGIS Enterprise portal! Below is an example of this email for expiring licenses:

 

Email notification warning of an upcoming ArcGIS Enterprise portal license expiration
Email notification warning of an upcoming ArcGIS Enterprise portal license expiration

Get started in 4 easy steps

Step 1: Navigate to the Portal Administrator Directory

In 10.8.1, to configure your Enterprise portal to send emails navigate to the Portal Administrator Directory.  Log in as a member either assigned the default administrator role or as a member assigned to a custom role which includes the Security and Infrastructure privilege.

Step 2: Navigate to the Email settings API

Once signed in, navigate to System – Email settings.  This is the interface you will use to configure and manage your organization’s email settings.

New email settings in the Portal Administrator Directory
New email settings in the Portal Administrator Directory

Step 3: Enter in your SMTP connection details

Click on the Update operation.  You will be presented with several parameters that you must specify to connect to your SMTP server.  You may need to work with your IT administrative team to retrieve this information.  You can find more details on each of these parameters here Email Settings REST API documentation.  Once you have filled in these parameters to connect to your SMTP server, click Configure. 

Configuring the email settings
Configuring the settings to connect to your organization's SMTP server.

Step four: Test your SMTP connection 

After your email settings have been saved, you will need to verify that the Enterprise portal is able to connect to and send emails through your email server.  To do this, use the Test email settings operation.  Enter in an email address that you have access to in order to confirm that the test email was successfully sent and delivered.

Once you have successfully received the test email above, your Enterprise portal is ready to start sending emails.

Tips for success

When configuring your Enterprise portal to send emails, it is important you ensure the following:

If an email notification fails to deliver, the details of this error will be logged and can be accessed through the Portal Administrator Directory. You may have to work with your IT team to troubleshoot and access logs for the SMTP server.

Let us know what you think!

We want to continue adding new email notifications that are important to you. Drop a comment below if there are any specific email notifications that you would like to see in an upcoming release of ArcGIS Enterprise.

About the author

Joel Jeyarajah

I am a product engineer on the ArcGIS Enterprise team. GIS was the obvious path for a data enthusiast.

Connect:

11
Leave a Reply

Please Login to comment
newest oldest
John Dye
John Dye
George Shi
George Shi

Although I followed every step in your article, I still haven’t got it work:
1) It complained about mailFrom email address when I put my working email address:

Looks like it accept .com domain like xyz@yahoo.com.

However, I work for a Canadian organization. My email address ends up with .ca.

2) When I tested it using a valid recipient email address, it failed again:
Error
java.lang.RuntimeException: java.lang.Exception: The server at ‘https://xxxxxxxxx.CA:7443/arcgis/sharing/rest/portals/0123456789ABCDEF/emailSettings/test’ returned an error. SMTPSendFailedException: 452 4.3.1 Insufficient system resources (UsedDiskSpace[C:\Program Files\Microsoft\Exchange Server\V15\TransportRoles\data\Queue]) [“SMTPSendFailedException: 452 4.3.1 Insufficient system resources (UsedDiskSpace[C:\\Program Files\\Microsoft\\Exchange Server\\V15\\TransportRoles\\data\\Queue])\n”]
Code: 500

Any hints?

Helena Taflin
Helena Taflin

Is there the ability for the server to send email notifications when there are severe warnings in the logs?

J Tessier
J Tessier

Hi Joel, my devs reported to me that the webhooks capabilities in portal does not/cannot directly utilize the SMTP setup in the portal at 10.8.1. This would be something we would like to see in the near future. Thanks.
Also I second your effort to allow folks to subscribe to certain events (group membership requests and invites being an obvious one). Hoe to see that in a near future release.

Next Article

One Minute Map Hacks: 31-35

Read this article