OnDemand
Contents
Preface.................................................................................................................4
Disclaimer of Warranty................................................................................................................................. 4
Copyright.......................................................................................................................................................4
Trademarks................................................................................................................................................... 4
Government Rights Legend......................................................................................................................... 4
Virus-free software policy............................................................................................................................. 4
Document Revision Numbers.......................................................................................................................4
AgilePoint Documentation in PDF and HTML............................................................................................. 5
Opening the Documentation Library............................................................................................................ 5
Finding Information in the Documentation Library....................................................................................... 6
Downloading Files and Sharing Links from the Documentation Library...................................................... 6
Contact AgilePoint Sales..............................................................................................................................7
Contact AgilePoint Customer Support......................................................................................................... 7
Basic Administration....................................................................................... 74
Add Users to AgilePoint NX.......................................................................................................................74
Add a User with an AgilePoint ID................................................................................................... 74
Add More Than One User to AgilePoint NX................................................................................... 81
Add System Administrators........................................................................................................................ 85
Add an Authentication Type.......................................................................................................................89
Enable AgilePoint ID Authentication................................................................................................91
Enable Salesforce Authentication....................................................................................................92
Enable Windows Azure Active Directory Authentication................................................................. 95
Enable Office 365 SharePoint Online Authentication......................................................................97
Preface
Disclaimer of Warranty
AgilePoint, Inc. makes no representations or warranties, either express or implied, by or with respect to anything
in this document, and shall not be liable for any implied warranties of merchantability or fitness for a particular
purpose or for any indirect, special or consequential damages.
Copyright
Copyright 2016 AgilePoint, Inc. All rights reserved.
Trademarks
AgilePoint, Inc. and AgilePoint's products are trademarks of AgilePoint Inc. References to other companies and
their products use trademarks owned by the respective companies and are for reference purpose only.
AgilePoint is built on top of Microsoft .NET framework. The pre-compiled executable is a.NET Common
Language Runtime (CLR) application, not a native machine binary. As far as is known at this time, there are
no viruses that infect .NET CLR executables.
The virtual environment for the product packaging process in is fully isolated and protected, and anti-virus
software is installed and running during packaging.
The deliverable package is scanned by anti-virus software before upload to our customer download site.
r - Indicates "revision." This helps to differentiate the document version numbers, which start with v.
X - The major version number for AgilePoint to which this document refers. For example, AgilePoint releases
5.0, 5.0 SP1, and 5.5 would all have an X value of 5.
Y - The major document revision number. This number typically changes only when either there is a new
AgilePoint release, or there are major changes to the document.
Z - The minor document revision number. This number is incremented each time the document is
republished.
Prerequisites
You must have a valid account on the AgilePoint Support Portal.
Instructions
1. Log on to the AgilePoint Support Portal.
2. Click Documentation.
3. On the Documentation page, click the documentation library for your AgilePoint release.
For AgilePoint v5.0 SP1 and higher, the web-based documentation library opens in a new tab or window
in your web browser.
For releases prior to v5.0 SP1, a download starts for a Zip file with the PDF documentation for your
release.
Searching
The web-based documentation includes a centralized search for all documentation content. To search for
information:
1. In the AgilePoint Documentation Library, click the Search tab. In the Search box, enter 1 search team, and
click Search.
The search results display in alphabetical order by topic title.
It is important to understand that the third-party software AgilePoint uses to generate web-based
documentation allows only 1 search term. More than 1 search term will cause the search to fail.
AgilePoint recommends using a relatively unique search term to find the information you need. For example,
entering a common term, such as "process," will return a high percentage of the total documentation topics
in the search results.
2. Browse the list of topic titles to find the information you want.
Printing
The PDF documentation is provided mainly for the purpose of printing and archiving. To print a set of
information:
1. Navigate to the main page of the Documentation Library from which you want to print.
2. In the list of documents, click the document name in the PDF column.
3. From your PDF reader software, print the portion of the document you want.
If your organization does not use AgilePoint NX now, send an e-mail to nx.sales@agilepoint.com to
request an invitation.
If your organization uses AgilePoint NX, request an account from your system administration.
RelatedTopics
Sign In screen
Good to Know
If you can not access AgilePoint NX, the nxone.com domain may be blocked on your organization's network.
For more information, refer to I Can Not Access AgilePoint NX from My Company's Network
All users get an AgilePoint ID. However, you may or may not use this ID to sign in to AgilePoint NX. This
depends upon whether your organization uses AgilePoint authentication, or a third-party authentication
provider, such as Salesforce or Microsoft. For more information, ask your system administrator.
Procedure
1. Send an e-mail to nx.sales@agilepoint.com to request an invitation.
2. In the AgilePoint NX Trial Tenant Invitation e-mail, click AgilePoint NX Trial Acceptance.
3. On the Register With screen, click on the authentication type to create an AgilePoint account.
AgilePoint ID Function:
Signs you in with a user name for an AgilePoint
NX account.
All users get an AgilePoint ID. However, you may
or may not use this ID to sign in to AgilePoint NX.
This depends upon whether your organization
uses AgilePoint authentication, or a third-party
authentication provider, such as Salesforce or
Microsoft. For more information, ask your system
administrator.
For more information, refer to Register with an
AgilePoint ID.
Salesforce Function:
Signs you in with a Salesforce account.
Google Function:
Signs you in with a Google account.
For more information, refer to Register with
Google.
RelatedTopics
I Can Not Access AgilePoint NX from My Company's Network
AgilePoint NX Trial Tenant Invitation e-mail
AgilePoint NX Trial Tenant Confirmation e-mail
Why Can I Not Open AgilePoint NX?
Good to Know
All users get an AgilePoint ID. However, you may or may not use this ID to sign in to AgilePoint NX. This
depends upon whether your organization uses AgilePoint authentication, or a third-party authentication
provider, such as Salesforce or Microsoft. For more information, ask your system administrator.
How to Start
1. On the AgilePoint NX Trial Tenant Invitation e-mail, click AgilePoint NX Trial Acceptance.
2. On the Register With screen, click AgilePoint ID.
Procedure
1. On the AgilePoint ID Registration screen, complete these fields as necessary.
Accepted Values:
Default Value:
None if you register with AgilePoint ID.
If you register with an external authentication
provider, this field shows the information from
your external account.
Password Function:
Specifies a password for your AgilePoint NX
account.
Accepted Values:
One line of text with no spaces.
You can include special characters and numbers
to increase the strength of your password.
Default Value:
None.
If you register with an external authentication
provider, this field does not show and your
password is the same as your external account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text with no spaces.
Default Value:
None.
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
E-mail Function:
Specifies your e-mail account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Phone Function:
Specifies the phone number of the user.
Accepted Values:
A number string.
Region Function:
Specifies the geographic region of the user.
Accepted Values:
A geographic region from the list.
Default Value:
US East (Virginia).
If you register with an external authentication
provider, this field shows the information from
your external account..
2. Click Register.
Within 24 hours, AgilePoint sends the AgilePoint NX Trial Tenant Confirmation e-mail.
3. In the AgilePoint NX trial tenant confirmation e-mail, click the link for your Tenant Access URL.
RelatedTopics
AgilePoint NX Trial Tenant Confirmation e-mail
AgilePoint NX Trial Tenant Invitation e-mail
Register With screen
Good to Know
If you can not access AgilePoint NX, the nxone.com domain may be blocked on your organization's network.
For more information, refer to I Can Not Access AgilePoint NX from My Company's Network
AgilePoint NX requires access your basic information in Salesforce, access to your unique identifier,
permission to access and manage your data, and perform requests on your behalf at any time.
How to Start
1. On the AgilePoint NX Trial Tenant Invitation e-mail, click AgilePoint NX Trial Acceptance.
2. On the Register With screen, click Salesforce.
Procedure
1. On the Salesforce Login screen, enter your Salesforce user name and password.
Accepted Values:
Default Value:
None if you register with AgilePoint ID.
If you register with an external authentication
provider, this field shows the information from
your external account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
E-mail Function:
Specifies your e-mail account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Phone Function:
Specifies the phone number of the user.
Accepted Values:
A number string.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Region Function:
Specifies the geographic region of the user.
Accepted Values:
A geographic region from the list.
Default Value:
US East (Virginia).
5. Click Register.
Within 24 hours, AgilePoint sends the AgilePoint NX Trial Tenant Confirmation e-mail.
6. In the AgilePoint NX trial tenant confirmation e-mail, click the link for your Tenant Access URL.
RelatedTopics
AgilePoint NX Trial Tenant Invitation e-mail
Register With screen
Good to Know
AgilePoint NX registration requires permission for AgilePoint NX to sign in to your account, access your
organization's directory, and read user profiles.
How to Start
1. On the AgilePoint NX Trial Tenant Invitation e-mail, click AgilePoint NX Trial Acceptance.
2. On the Register With screen, click Windows Azure Active Directory.
Procedure
1. On the Windows Sign In screen, enter your Windows Azure Active Directory e-mail address and password.
2. Click Sign In
3. In the Allow Permission screen, click Accept.
Accepted Values:
Default Value:
None if you register with AgilePoint ID.
If you register with an external authentication
provider, this field shows the information from
your external account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
E-mail Function:
Specifies your e-mail account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Phone Function:
Specifies the phone number of the user.
Accepted Values:
A number string.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Region Function:
Specifies the geographic region of the user.
Accepted Values:
A geographic region from the list.
Default Value:
US East (Virginia).
5. Click Register.
Within 24 hours, AgilePoint sends the AgilePoint NX Trial Tenant Confirmation e-mail.
6. In the AgilePoint NX trial tenant confirmation e-mail, click the link for your Tenant Access URL.
RelatedTopics
AgilePoint NX Trial Tenant Invitation e-mail
AgilePoint NX Trial Tenant Confirmation e-mail
Good to Know
AgilePoint NX registration requires permission for AgilePoint NX to sign in to your account, access your
organization's directory, and read user profiles.
How to Start
1. On the AgilePoint NX Trial Tenant Invitation e-mail, click AgilePoint NX Trial Acceptance.
2. On the Register With screen, click Office 365 SharePoint Online.
Procedure
1. In the Windows Sign In screen, enter your Office 365 SharePoint Online e-mail address and password.
Accepted Values:
Default Value:
None if you register with AgilePoint ID.
If you register with an external authentication
provider, this field shows the information from
your external account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
E-mail Function:
Specifies your e-mail account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Phone Function:
Specifies the phone number of the user.
Accepted Values:
A number string.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Region Function:
Specifies the geographic region of the user.
Accepted Values:
A geographic region from the list.
Default Value:
US East (Virginia).
5. Click Register.
Within 24 hours, AgilePoint sends the AgilePoint NX Trial Tenant Confirmation e-mail.
6. In the AgilePoint NX trial tenant confirmation e-mail, click the link for your Tenant Access URL.
RelatedTopics
AgilePoint NX Trial Tenant Invitation e-mail
AgilePoint NX Trial Tenant Confirmation e-mail
Good to Know
If you can not access AgilePoint NX, the nxone.com domain may be blocked on your organization's network.
For more information, refer to I Can Not Access AgilePoint NX from My Company's Network
AgilePoint NX requires access your basic information in Google account, access to your unique identifier,
permission to access and manage your data, and perform requests on your behalf at any time.
How to Start
1. On the AgilePoint NX Trial Tenant Invitation e-mail, click AgilePoint NX Trial Acceptance.
2. On the Register With screen, click Google.
Procedure
1. On the Google sign-in screen, enter your Google account user name and password.
Accepted Values:
Default Value:
None if you register with AgilePoint ID.
If you register with an external authentication
provider, this field shows the information from
your external account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Accepted Values:
One line of text that can have spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
E-mail Function:
Specifies your e-mail account.
Accepted Values:
One line of text with no spaces.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Phone Function:
Specifies the phone number of the user.
Accepted Values:
A number string.
Default Value:
None.
If you register with an external authentication
provider, this field shows the information from
your external account..
Region Function:
Specifies the geographic region of the user.
Accepted Values:
A geographic region from the list.
Default Value:
US East (Virginia).
5. Click Register.
Within 24 hours, AgilePoint sends the AgilePoint NX Trial Tenant Confirmation e-mail.
6. In the AgilePoint NX trial tenant confirmation e-mail, click the link for your Tenant Access URL.
RelatedTopics
AgilePoint NX Trial Tenant Invitation e-mail
Register With screen
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
Procedure
1. Add Relying Party Trusts for AgilePoint NX Portal.
2. Add Relying Party Trusts for AgilePoint Server.
3. Add an OAuth Client for AgilePoint NX Portal.
4. Add OAuth Client for AgilePoint Server.
5. Configure AgilePoint NX Portal for ADFS Authentication.
6. Configure AgilePoint Server for ADFS Authentication.
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
How to Start
1. Sign in to ADFS sever as an administrator.
2. Click AD FS > AD FS Management
3. On the AD FS screen, in the left pane, click AD FS > Trust Relationships > Relying Party Trusts.
4. On the right pane, in the Actions, click Add Replying Party Trust.
Procedure
1. On the Welcome screen, click Start.
2. On the Select Data Source screen, select Enter data about the relying part manually.
3. Click Next.
4. On the Specify Display Name screen, in the Display Name field, enter the name for this relying party trust.
Example:
AgilePoint NX Portal
5. Click Next.
6. On the Choose Profile screen, select AD FS profile.
7. Click Next.
8. On the Configure Certificate screen, to skip the token encryption certificate, click Next.
9. On the Configure URL screen, deselect these fields:
Enable support for the WS-Federation Passive protocol
Enable support for the SAML 2.0 WebSSO protocol
This is the default option.
10. Click Next.
11. On the Configure Identifiers screen, in the Replying party trust identifier field, enter a unique URL as an
identifier for your portal.
Example:
https://apportal.com/adfs/services/trust
It is recommended to record this URL for more use.
12. Click ADD.
13. Click Next.
14. On the Configure Multi-factor Authentication Now? screen, select I do not want to configure multi-
factor authentication settings for this relying party trust at this time.
This is the default option.
15. Click Next.
16. On the Choose Insurance Authorization Rules screen, select Permit all users to access this relying
party.
This is the default option.
17. Click Next.
18. On the Ready to Add Trust screen, deselect all the options.
This is the default option.
19. Click Next.
20. On the Finish screen, select Open the Edit Claim Rules dialog for this relying party trust when the
wizard closes.
This is the default option.
21. Click Close.
22. On the Edit Claim Rules screen, in the Issuance Transform Rules tab, click Add Rule.
23. On the Select Rule Template screen, in the Claim rule template list, select Send LDAP Attributes as
Claims.
24. Click Next.
25. On the Configure Rule screen, in the Claim rule name field, enter the name of the claim rule.
Example:
Basic Claims
26. In the Attribute store list, select Active Directory.
27. On the Mapping of LDAP attributes to outgoing claim types, select the claims you want to send.
Do not configure NAME Outgoing Claim.
Example:
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
How to Start
1. Sign in to ADFS sever as an administrator.
2. Click AD FS > AD FS Management
3. On the AD FS screen, in the left pane, click AD FS > Trust Relationships > Relying Party Trusts.
4. On the right pane, in the Actions, click Add Replying Party Trust.
Procedure
1. On the Welcome screen, click Start.
2. On the Select Data Source screen, select Enter data about the relying part manually.
3. Click Next.
4. On the Specify Display Name screen, in the Display Name field, enter the name for this relying party trust.
Example:
AgilePoint Server
5. Click Next.
6. On the Choose Profile screen, select AD FS profile.
7. Click Next.
8. On the Configure Certificate screen, to skip the token encryption certificate, click Next.
9. Click Next.
10. On the Configure URL screen, deselect these fields:
Enable support for the WS-Federation Passive protocol
Enable support for the SAML 2.0 WebSSO protocol
This is the default option.
11. Click Next.
12. On the Configure Identifiers screen, in the Replying party trust identifier field, enter a unique URL as an
identifier for your your server.
Example:
https://apserver.com/adfs/services/trust.
It is recommended to record this URL for more use.
13. Click ADD.
14. Click Next.
15. On the Configure Multi-factor Authentication Now? screen, select I do not want to configure multi-
factor authentication settings for this relying party trust at this time.
This is the default option.
16. Click Next.
17. On the Choose Insurance Authorization Rules screen, select Permit all users to access this relying
party.
This is the default option.
18. Click Next.
19. On the Ready to Add Trust screen, deselect all the options.
This is the default option.
20. Click Next.
21. On the Finish screen, select Open the Edit Claim Rules dialog for this relying party trust when the
wizard closes.
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
How to Start
1. Click start menu > Search box > enter Windows PowerShell.
2. Right-click Windows PowerShell.
3. Click Run as administrator.
Procedure
1. Run this command to add ADFS client for AgilePoint NX Portal.
Add-ADFSClient
-Name "[your portal name]"
-ClientId "[GUID]" //Supply a new GUID from any tool. For example, in Visual
Studio.
-RedirectUri="[your portal url]/signin/adfsportalcallback"
Example:
Add-ADFSClient
-Name "AgilePoint Portal"
-ClientId "573BBC65-F28C-4AA4-94ED-D4294D395C78"
-RedirectUri="https://demo3:13491/signin/adfsportalcallback"
It is recommended to record the ClientId for later use.
2. Run these commands to enable the app to supply a token.
Set-AdfsRelyingPartyTrust
-TargetName "[your portal name]"
-IssueOAuthRefreshTokensTo AllDevices
Set-AdfsRelyingPartyTrust
-TargetName "[your portal name]"
-TokenLifetime 40
Set-AdfsProperties
-SSOLifetime 480
Example:
Set-AdfsRelyingPartyTrust
-TargetName "AgilePoint Portal"
-IssueOAuthRefreshTokensTo AllDevices
Set-AdfsRelyingPartyTrust
-TargetName "AgilePoint Portal"
-TokenLifetime 40
Set-AdfsProperties
-SSOLifetime 480
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
How to Start
1. Click start menu > Search box > enter Windows PowerShell.
2. Right-click Windows PowerShell.
3. Click Run as administrator.
Procedure
1. Run this command to add ADFS client for AgilePoint Server.
Add-ADFSClient
-Name "[your server name]"
-ClientId "[GUID]" //Supply a new GUID from any tool. For example, in Visual
Studio.
-RedirectUri="[your portal url]/signin/adfsservercallback"
Example:
Add-ADFSClient
-Name "AgilePoint Server"
-ClientId "96E14D9B-6FCF-4BCD-9E0A-B30623AE1939"
-RedirectUri="https://demo3:13491/signin/adfsservercallback"
It is recommended to record the ClientId for later use.
2. Run these commands to enable the app to supply a token.
Set-AdfsRelyingPartyTrust
-TargetName "[your server name]"
-IssueOAuthRefreshTokensTo AllDevices
Set-AdfsRelyingPartyTrust
-TargetName "[your server name]"
-TokenLifetime 40
Set-AdfsProperties
-SSOLifetime 480
Example:
Set-AdfsRelyingPartyTrust
-TargetName "AgilePoint Server"
-IssueOAuthRefreshTokensTo AllDevices
Set-AdfsRelyingPartyTrust
-TargetName "AgilePoint Server"
-TokenLifetime 40
Set-AdfsProperties
-SSOLifetime 480
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
How to Start
1. On your AgilePoint Server machine, open the file [AgilePoint Portal installation folder]\web.config
Procedure
1. Add or change these keys to the web.config file for your AD FS authentication.
<appSettings>
<add key="adfs:PortalClientId" value="[ClientID of your portal OAuth]" />
<add key="adfs:PortalResourceUri" value="[URI of Replying party trust
identifier for your portal]" />
<add key="adfs:Authority" value="[ADFS server URL]" />
<add key="adfs:ServerClientId" value="[The ClientID of your server OAuth]" />
<add key="adfs:ServerResourceUri" value="[The URI of Replying party trust
identifier for your server]" />
</appSettings>
Example:
<appSettings>
<add key="adfs:PortalClientId" value="573BBC65-F28C-4AA4-94ED-D4294D395C78"/>
<add key="adfs:PortalResourceUri" value="https://apportal.com/adfs/services/
trust" />
<add key="adfs:Authority" value="https://adfs.agilityclouds.com" />
<add key="adfs:ServerClientId" value="96E14D9B-6FCF-4BCD-9E0A-B30623AE1939" />
<add key="adfs:ServerResourceUri" value="https://apserver.com/adfs/services/
trust" />
</appSettings>
2. Change ActiveDirectory to ADFS in ActiveAuthProviders key to the web.config file.
<appSettings>
<add key="ActiveAuthProviders" value="ActiveDirectory" />
</appSettings>
Example:
<appSettings>
<add key="ActiveAuthProviders" value="ADFS" />
</appSettings>
3. Right-click [AgilePoint Portal installation folder]\bin\Orchard.exe
4. Click Run as an administrator.
5. Run this command.
feature enable AgilePoint.Portal.Security.Persistence
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
AgilePoint NX v6.0 Software Update 6 or higher.
ADFS 3 Server installed in your environment.
How to Start
1. On your AgilePoint Server machine, open the file [AgilePoint Server instance installation folder]\bin
\Ascentn.AgilePoint.WCFService.exe.config
Procedure
1. Add or change these keys to the Ascentn.AgilePoint.WCFService.exe.config file for your AD FS
authentication.
<appSettings>
<add key="ADFS_Authority" value="[ADFS server URL]" />
<add key="ADFS_ServerAudienceUrl" value="[URI of Replying party trust
identifier for AgilePoint Server]" />
Sign In to AgilePoint NX
To sign in to AgilePoint NX, do the procedure in this topic.
Prerequisites
Your authentication provider must be enabled in AgilePoint NX.
For more information, refer to Add an Authentication Type.
Your account must be registered in AgilePoint NX.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click the name of your authentication provider.
AgilePoint ID Function:
Signs you in with a user name for an AgilePoint
NX account.
Salesforce Function:
Signs you in with a Salesforce account.
For more information, refer to Sign In with
Salesforce.
Google Function:
Signs you in with a Google account.
For more information, refer to Sign In with Google.
ADFS Function:
Signs you in with ADFS account.
For more information, refer to Sign In with ADFS.
RelatedTopics
Sign In screen
Add an Authentication Type
Register an AgilePoint NX Account
Prerequisites
Enable AgilePoint ID Authentication.
Register with an AgilePoint ID or Add a User with an AgilePoint ID.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click AgilePoint ID.
2. On the sign in screen, enter your AgilePoint user name and password.
3. Click Login.
If you sign in first time, this screen shows.
4. AgilePoint NX opens.
RelatedTopics
Sign In to AgilePoint NX
Enable AgilePoint ID Authentication.
Register with an AgilePoint ID or Add a User with an AgilePoint ID.
Add Users to AgilePoint NX
Prerequisites
Enable Salesforce Authentication.
Register with Salesforce.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click Salesforce.
2. On the Salesforce login screen, enter your Salesforce account user name and password.
When your sign in is successful, you go to nxone.com and your AgilePoint NX environment.
If you sign in first time, this screen shows.
4. AgilePoint NX opens.
RelatedTopics
Sign In to AgilePoint NX
Enable Salesforce Authentication.
Register with Salesforce.
Prerequisites
Enable Windows Azure Active Directory Authentication.
Register with Windows Azure Active Directory.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click Windows Azure Active Directory.
2. On the sign in screen, enter your Windows Azure Active Directory e-mail address and password.
When your sign in is successful, you go to nxone.com and your AgilePoint NX environment.
If you sign in first time, this screen shows.
4. AgilePoint NX opens.
RelatedTopics
Sign In to AgilePoint NX
Enable Windows Azure Active Directory Authentication.
Register with Windows Azure Active Directory.
Prerequisites
Enable Office 365 SharePoint Online Authentication.
Register with Office 365 SharePoint Online.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click Office 365 SharePoint Online.
2. On the sign-in screen, enter your Office 365 e-mail address and password.
When your sign in is successful, you go to nxone.com and your AgilePoint NX environment.
If you sign in first time, this screen shows.
4. AgilePoint NX opens.
RelatedTopics
Sign In to AgilePoint NX
Enable Office 365 SharePoint Online Authentication.
Register with Office 365 SharePoint Online.
Prerequisites
Enable Google Authentication.
Register with Google.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click Google.
2. On the Google sign-in screen, enter your Google account user name and password.
4. AgilePoint NX opens.
RelatedTopics
Sign In to AgilePoint NX
Enable Google Authentication.
Register with Google.
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
Configure ADFS Authentication for ADFS account.
Good to Know
If you are in the same network in which the ADFS is configured, you can open AgilePoint NX portal without
signing in.
How to Start
1. Click https://login.nxone.com/login.
Procedure
1. On the Sign In with screen, click ADFS.
2. On the sign in screen, enter your ADFS user name and password.
4. AgilePoint NX opens.
RelatedTopics
Sign In to AgilePoint NX
Enable Windows Azure Active Directory Authentication.
Register with Windows Azure Active Directory.
Basic Administration
Once you have an AgilePoint NX administrator account, you can start to add users and customize your
environment.
This section provides basic information about AgilePoint NX administration. For more information, refer to:
Settings
Manage Center
Good to Know
The nxone domain is shared across all tenants in the public cloud. If the user name you want is not
available, you will be prompted with a message when you click Add User. You must find a user name that is
unique.
If Auto Sync is enabled on the Admin Settings screen, new users can automatically sign in with the enabled
authentication providers. In this case, users do not need to be added using their AgilePoint IDs.
All new users are added to the Users role.
If the users from an Windows Azure Active Directory or Office 365 domain are added to AgilePoint NX,
external users from the domain are not added. The system administrator must add these external users to
AgilePoint NX separately.
For more information, refer to I Can Not Sign In to AgilePoint NX OnDemand as an external WAAD/Office
365 User.
Procedure
1. Do one of these:
Add a User with an AgilePoint ID.
Add More Than One User with AgilePoint IDs.
RelatedTopics
Sign In to AgilePoint NX
Add a User with an AgilePoint ID
Add More Than One User with AgilePoint IDs
Admin Settings screen
Good to Know
The nxone domain is shared across all tenants in the public cloud. If the user name you want is not
available, you will be prompted with a message when you click Add User. You must find a user name that is
unique.
If Auto Sync is enabled on the Admin Settings screen, new users can automatically sign in with the enabled
authentication providers. In this case, users do not need to be added using their AgilePoint IDs.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the Admin Settings screen, in the Add Users - Single User field, click click here.
2. On the Create New User screen screen that opens in a new tab, complete these fields as necessary.
Accepted Values:
One line of text that can have spaces.
Default Value:
None if you register with AgilePoint ID.
If you register with an external authentication
provider, this field shows the information from
your external account.
Accepted Values:
A text string that can contain spaces.
Default Value:
None
Department Function:
Specifies the user's department.
The value of this field is used for the My
Department view in the Work Center. For more
information, refer to Tasks.
Accepted Values:
A text string that can contain spaces.
Default Value:
None
Accepted Values:
A valid e-mail address.
Default Value:
None
Title Function:
Specifies the job title of the user.
Accepted Values:
The name of your job title.
Default Value:
None
Manager Function:
Specifies the user's manager.
The value of this field is used for the My Direct
Team and My Team And Sub view in the Work
Center. For more information, refer to Tasks.
Default Value:
None
Language Function:
Specifies the language of the user.
Accepted Values:
A valid 2-letter ISO language code.
Default Value:
None
Accepted Values:
A valid Yammer ID.
Accepted Values:
A valid Lync ID.
Accepted Values:
A valid Chatter ID.
Accepted Values:
A number string.
3. In the User Authentication Type field, select AgilePoint ID and click Add User.
4. (Optional) On the New User Added screen, click Access Rights to add user to applicable roles. By default,
all registered users are added to the role Users in the system.
5. (Optional) On the New User Access Rights screen, select the roles for the user.
6. Click Finish.
The AgilePoint NX system sends new users the AgilePoint NX New User Confirmation e-mail with a system-
generated password to the e-mail addresses in their user profiles.
RelatedTopics
Sign In to AgilePoint NX
Admin Settings screen
Create New User screen
New User Added screen
New User Access Rights screen
AgilePoint NX New User Confirmation e-mail;
Good to Know
The nxone domain is shared across all tenants in the public cloud. If the user name you want is not
available, you will be prompted with a message when you click Add User. You must find a user name that is
unique.
If Auto Sync is enabled on the Admin Settings screen, new users can automatically sign in with the enabled
authentication providers. In this case, users do not need to be added using their AgilePoint IDs.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
3. Click Bulk Upload tab.
Procedure
1. On the Admin Settings screen, in the Add Users - Bulk Upload field, select the authentication type for the
new users to sign in.
The AgilePoint NX system sends new users the AgilePoint NX New User Confirmation e-mail with a system-
generated password to the e-mail addresses in their user profiles.
RelatedTopics
Sign In to AgilePoint NX
Admin Settings screen
AgilePoint NX New User Confirmation e-mail
Prerequisites
Sign In to AgilePoint NX as an administrator.
How to Start
1.
In the Manage Center, click Access Control > Roles.
Procedure
1. On the Roles screen, in the Role Name column, select Administrators.
2.
Click Edit .
3.
On the Manage Members tab, click Add Member .
6. Click OK.
7. Click Update.
RelatedTopics
Manage Members
Add Members
Prerequisites
This procedure only applies to AgilePoint NX OnDemand (public cloud). For AgilePoint NX OnPremises or
AgilePoint NX PrivateCloud, refer to How Do I Set Up More than One Authentication Type in AgilePoint NX
On Premises?.
You must sign in to AgilePoint NX as an administrator.
Good to Know
You can enable more than one account of the same third-party service, such as Office 365 or Salesforce.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click your authentication type.
AgilePoint ID Function:
Enables native AgilePoint authentication.
For more information, refer to Enable AgilePoint
ID Authentication.
Salesforce Function:
Enables Salesforce authentication.
For more information, refer to Enable Salesforce
Authentication.
Google Function:
Enables Google account authentication.
For more information, refer to Enable Google
Authentication.
RelatedTopics
Enable AgilePoint ID Authentication
Enable Salesforce Authentication
Enable Windows Azure Active Directory Authentication
Enable Office 365 SharePoint Online Authentication
Enable Google Authentication
Admin Settings screen
Prerequisites
You must sign in to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click AgilePoint ID.
2. On the Enable AgilePoint ID Authentication screen, enter your user name, password, and e-mail address.
RelatedTopics
Enable Salesforce Authentication
Enable Windows Azure Active Directory Authentication
Enable Office 365 SharePoint Online Authentication
Admin Settings screen
Prerequisites
You must sign in to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click Salesforce.
2. (Optional) In Auto sync user profile on successful login field, select Yes to synchronize the users in your
AgilePoint NX environment with a third-party service.
These users can sign in to AgilePoint NX with their third-party service credentials.
Auto Sync is disabled in development environments. For more information, refer to Why Can I Not Turn On
Auto Sync for Third-Party Authentication in a Development Environment?.
3. (Optional) In the Sync user email IDs field, select Yes to synchronize the users' e-mail IDs in your
AgilePoint NX environment with a third-party service.
4. On the Enable Salesforce Authentication screen, click Ok.
5. On the Salesforce login screen, enter your Salesforce account user name and password.
RelatedTopics
Enable AgilePoint ID Authentication
Enable Windows Azure Active Directory Authentication
Prerequisites
You must sign in to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click Windows Azure Active Directory.
2. (Optional) In Auto sync user profile on successful login field, select Yes to synchronize the users in your
AgilePoint NX environment with a third-party service.
These users can sign in to AgilePoint NX with their third-party service credentials.
Auto Sync is disabled in development environments. For more information, refer to Why Can I Not Turn On
Auto Sync for Third-Party Authentication in a Development Environment?.
3. On the Enable Windows Azure Active Directory Authentication screen, click Ok.
4. On the sign in screen, enter your Windows Azure Active Directory e-mail address and password.
RelatedTopics
Enable AgilePoint ID Authentication
Enable Salesforce Authentication
Prerequisites
You must sign in to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click Office 365 SharePoint Online.
2. (Optional) In Auto sync user profile on successful login field, select Yes to synchronize the users in your
AgilePoint NX environment with a third-party service.
These users can sign in to AgilePoint NX with their third-party service credentials.
Auto Sync is disabled in development environments. For more information, refer to Why Can I Not Turn On
Auto Sync for Third-Party Authentication in a Development Environment?.
3. On the Enable Office 365 SharePoint Online Authentication screen, click Ok.
4. On the sign-in screen, enter your Office 365 e-mail address and password.
RelatedTopics
Enable AgilePoint ID Authentication
Enable Salesforce Authentication
Prerequisites
You must sign in to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click Google.
2. (Optional) In Auto sync user profile on successful login field, select Yes to synchronize the users in your
AgilePoint NX environment with a third-party service.
These users can sign in to AgilePoint NX with their third-party service credentials.
Auto Sync is disabled in development environments. For more information, refer to Why Can I Not Turn On
Auto Sync for Third-Party Authentication in a Development Environment?.
3. (Optional) In the Sync user email IDs field, select Yes to synchronize the users' e-mail IDs in your
AgilePoint NX environment with a third-party service.
4. On the Enable Google Authentication screen, click Ok.
5. On the Google sign-in screen, enter your Google account user name and password.
RelatedTopics
Enable AgilePoint ID Authentication
Enable Windows Azure Active Directory Authentication
Enable Office 365 SharePoint Online Authentication
Admin Settings screen
Prerequisites
AgilePoint NX OnPremises or AgilePoint NX PrivateCloud environment.
You must sign in to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin settings screen, in the Available Authentications, click ADFS.
2. (Optional) In Auto sync user profile on successful login field, select Yes to synchronize the users in your
AgilePoint NX environment with a third-party service.
These users can sign in to AgilePoint NX with their third-party service credentials.
Auto Sync is disabled in development environments. For more information, refer to Why Can I Not Turn On
Auto Sync for Third-Party Authentication in a Development Environment?.
3. On the Enable ADFS Authentication screen, click Ok.
4. On the sign in screen, enter your Windows Azure Active Directory e-mail address and password.
RelatedTopics
Enable AgilePoint ID Authentication
Enable Salesforce Authentication
Enable Office 365 SharePoint Online Authentication
Admin Settings screen
Prerequisites
Your AgilePoint NX tenant has more than one authentication types.
For more information, refer to Add an Authentication Type.
Sign In to AgilePoint NX as an administrator.
How to Start
1.
Click Settings .
2.
Click Admin Settings .
Procedure
1. On the admin setting screen, in the Enabled Authentications, click Make Primary for your authentication
type.
RelatedTopics
Admin Settings screen
Change Environments
To open a different AgilePoint NX environment, do the procedure in this topic.
Prerequisites
This feature is only available for AgilePoint OnDemand (public cloud).
You must have more than one AgilePoint NX environment.
For more information, refer to How Do I Set Up More than One Environment in AgilePoint NX?.
Good to Know
If you change the environments, no data is shared between the environments.
These are the environments you can have:
Production
Development
Evaluation
How to Start
1. In the AgilePoint NX Portal, click your user name.
Procedure
1. On the context menu, click Switch to.
RelatedTopics
Sign In to AgilePoint NX
How Do I Set Up More than One Environment in AgilePoint NX?
Personalize AgilePoint NX
To personalize AgilePoint NX, do the procedure in this topic.
How to Start
1.
Click Settings .
Procedure
1. Configure these as necessary.
Document Description
Portal Branding Configures the branding for your portal site, such as
site name, logo, and banner.
Work Center Common Settings Configures the basic settings for the Work Center.
For example, max items to retrieve, items per page,
open task in new window, and task colors.
Work Center Column Settings Configures the columns that show in the Work
Center.
Work Center Tab Settings Configures how tabs show in the Work Center.
Build Apps Common Settings Configures the items that show in the App Builder.
Build Apps Process Designer Configures the Process Builder. For example,
enable quick start wizard for new application and
allow deleting application permanently.
Build Apps Form Designer Configures the eForm Builder. For example, launch
configuration window and toolbar settings.
RelatedTopics
Settings