Look Mum, No Passwords!

Look Mum, No Passwords!

Martin Leyrer, IBM

Thanks to our sponsors!

7th Sutol Conference, November 2015


● IBM Collaboration Solutions IT-Specialist with IBM Austria

● ICS product stack since 1995(Notes 3.3 on OS/2 on an i368)

● IBM e-mail: [email protected]

● E-mail: [email protected]

● Twitter: http://www.twitter.com/leyrer

● Facebook: https://www.facebook.com/leyrer

● Blog: http://www.leyon.at

● LinkedIn: http://at.linkedin.com/in/leyrer

Martin Leyrer - IBM

mailto:[email protected]


What?


Why (1/2) ?


Why (2/2) ?


Navigation

● The What And Why

● The Quick Win

– Notes Shared Login / ID Vault

– Automatic Client Configuration

– SPNEGO For iNotes And Webapps

● Expanding The Possibilities – SAML

● Q & A


Remove Notes Password Prompts with NSL – Notes Shared Login

● Enabled via policy (or manually by the end user)

● Locks and encrypts the Notes ID in the current Windows Profile using the PC SID (Security Identifier) and Microsoft's Data Protection API (DPAPI).

● Certificates within the ID are locked and bound to that PC and that OS profile.

● The old “Notes SingleLogon” feature has to be uninstalled.

● Limited to Windows.

● Need ID Vault

● Need Notes/Domino 8.5


Uninstall/Remove “Notes Single Logon” for NSL To Work


ID Vault

● Optional

● Server-based database

● Holds protected copies of IBM Notes user Ids

● Users are assigned to a vault through policy configuration

● Copies of user IDs are uploaded to a vault automatically once the policy has taken effect


The Benefits Of Using An ID Vault

● Authorized personnel can change (reset) passwords on IDs without access to the ID files or the vault

● Custom application to reset passwords

● Easy recovery of lost or damaged user IDs

● Automatic synchronization of multiple ID copies

● No user involvement during ID renames

● No user involvement during ID key rollover


ID Vault Setup 1


ID Vault Setup 2


ID Vault Setup 3


ID Vault Setup 4


ID Vault Setup 5


ID Vault Setup 6


ID Vault Setup 7


ID Vault Setup 8


ID Vault Setup 9


ID Vault - Security Settings Document / Policy


NSL - Security Settings Document / Policy


AND IT WORKS !

We have Single Sign On with Windows!


ID Vault – If It Does NOT Work

● Check whether the policies are actually coming down to the client

– Check Policy Synopsis for that user in the Admin Client

– Check the “($Policies)” view in the PNAB

– Modify the person entry in the Domino Directory & access mail server to initiate a policy push

● Roaming user? Did you remove the ID file from the PNAB?

– https://ibm.biz/BdFnm9

– 8.5.3 provides a new detachid.zip utility and “javaAgentForDetachid.java” (in utility\NotesCustomizationKit_1_0.zip

– RoamingIDIsInNAB=0 in the person document

https://ibm.biz/BdFnm9


Navigation


● The Quick Win



– Token Based Single Sign On for Sametime And Connections



● Q & A


Smooth Client Start


ConfigFile To The Rescue

● It IS possible to install and configure the Notes Client completely WITHOUT user interaction*

– See https://ibm.biz/BdFnmd for details

● The notes.ini parameter, ConfigFile= points to a text (.TXT) file that contains the parameters that the wizard needs. For example:

ConfigFile=C:\Program Files\Lotus\Notes\Data\setup.txt

* … except from the one time password prompt for the ID Vault

https://ibm.biz/BdFnmd


ConfigFile With Environment Variables

Starting with 8.5.1 the parameter CONFIGFILE= can contain system environment variables, too. In case the setup configuration file is stored next to the template notes.ini the following setting would apply to all Windows flavors:

CONFIGFILE=%ALLUSERSPROFILE%\Application Data\Lotus\Notes\Data\config.txt

which resolves to...

CONFIGFILE=C:\Documents and Settings\All Users\Application Data\Lotus\Notes\Data\config.txt


Setup.txt

Username=User Name/Acme

KeyfileName=c:\Program Files\Lotus\Notes\Data\username.id ID Vault!

Domino.Name=servername/Acme

Domino.Address=servername.acme.com

Domino.Port=TCPIP

Domino.Server=1

AdditionalServices=0

AdditionalServices.NetworkDial=0

Replication.Threshold=9999

Replication.Schedule=0

Starting with 8.5 the scripted setup code can resolve system environment variables on any line of the configuration file that is read in.


AND IT WORKS !

No More Useless Prompts!


Navigation


● The Quick Win






● Q & A


Token Based Single Sign On for Sametime And Connections● Works for Sametime Connect

Embedded Client

● Works for Connections Plugins

● Prerequisite: Properly configured “Multiple Server SSO” on Domino Server


LTPA Token

● The LTPA token is sent to the User Agent (Browser) as a Set-Cookie response header

● The user agent sends this to the target HTTP server as a Cookie request header for subsequent actions.

● Because browser user agents only send Cookie request headers to servers whose host name matches the issuer of the cookie, the server must share the same DNS (“DNS domain”) space as the other LTPA servers in the SSO group.

● The LTPA token, which includes user information and an expiration time, is signed by the issuer to ensure data integrity and is encrypted to ensure data privacy.

● LTPA tokens can be used only for SSO among LTPA servers that share the same key material (LTPA key)


Websphere LTPA Version 1 (“LtpaToken”)

● Contains

– the token expiration time

– the user identity (usually the LDAP distinguished name)

– a digital signature

● LTPA1 signatures are generated using SHA-1/RSA 1024-bit key

● After the digital signature has been attached, the user data and signature are encrypted with a 3DES key obtained from the LTPA key file


Websphere LTPA Version 2

● Same format as LTPA1 tokens

● can contain additional information relating to the security context of the authenticated user

● LTPA2 signatures are generated using SHA-1/RSA 1024-bit key

● After the digital signature has been attached, the user data and signature are encrypted with a 3DES or AES key obtained from the LTPA key file


Domino LTPA Version

● Contains

– a fixed-size and value header starting field

– a token creation time

– a token expiration time

– the authenticated user name (Domino FQDN)

– a message authentication code (MAC) covering all content

● Domino uses a shared key and SHA-1 to calculate a MAC over the content

● After the MAC has been attached, the user data and MAC are encrypted with a 3DES key obtained from the LTPA key file


LTPA Websphere vs. Domino

● Domino can consume (decrypt, parse and process) and generate (create and encrypt) either the Domino or Websphere formats

● WebSphere cannot consume or generate the Domino format.


WebSSO Configuration


Enable Multi Server SSO


Account Documents






Push Account Documents To Users via Document Settings/Policy


AND IT WORKS !

Automatic Configuration & Login for Connections and Sametime Plugin!


Navigation


● The Quick Win

– ID Vault





● Q & A


Windows Single Sign-on for Web Clients (SPNEGO)

● Available since Lotus Domino 8.5.1

● User acquires Kerberos credentials when starting Windows.

– Windows verifies user's password.

– Password never travels over the wire via HTTP.

● SSO technology leveraging the Windows credentials sometimes called by these names:

– SPNEGO (Simple and Protected GSS-API Negotiation Mechanism)

– Integrated Windows Authentication” for the Windows Intranet


Windows Single Sign-on for Web Clients (SPNEGO)

● SPNEGO-aware browsers know how to● ask Windows for a Kerberos ticket, based on

● browser configuration, and ● the user's requested URL.

● send the Kerberos ticket as part of SPNEGO protocol request

● SPNEGO-aware Domino validates the ticket to authenticate the user.


Setting Up SPNEGO

● Create a Domino Web SSO document (enable Windows single sign-on integration)

● Set up a SPN (Service Principal Name) for the Domino server in Active Directory

– Domino must run under an Active Directory account you set up for it

● Run domspnego

– Take the output and give it to your AD administrator to run setspn with

● Run setspn -a http://<dominohostname> <accountnamerunningdomino>

● Update person documents with AD name appended to FullName (and optional others like krbPrincipalName and LTPA User Name)


Update Domino Person Document for SPNEGO

● Update person documents with AD name appended to FullName (and optional others like krbPrincipalName and LTPA User Name)


AND IT WORKS !

Automatic Login to Domino in Internet Explorer and Firefox on Windows!


Navigation


● The Quick Win

– ID Vault





● Q & A


SAML – Security Assertion Markup Language

● Provides ease of use for end users – reduce the # of passwords to memorize

● The only “Notes password” is the IdP's password– And SPNEGO/Kerberos to Microsoft's ADFS can eliminate that prompt as

well

– Once a user has authenticated with the IdP they won’t be asked again

● Notes client uses SAML to fetch the user's ID file from the vault– ID file is stored in memory instead of being written to disk

● Works on Citrix, Linux, and Mac as well as Windows– Requires Notes Standard client– Support for Notes, iNotes, and Web Clients


SAML – IdP - Identity Provider (SSO)

● ADFS (Active Directory Federation Services in Windows 2008 and Windows 2012)

– SAML 2.0 only

– can be combined with SPNEGO

– Enhances Integrated Windows Authentication (IWA)

● TFIM (Tivoli Federated Identity Manager)

– SAML 1.1 and 2.0


SAML – Assertions

● IdP (Identity Providers) use HTTP or SOAP to communicate to SP (Service Providers) via XML based assertions

● Assertions have three roles

● Authentication

● Authorisation

● Retrieving Attributes


Notes Federated Login with SAML

1) User launches Notes and Notes connects to the ID Vault

2) The ID Vault (configured for SAML authentication) reaches out to IdP.

3) IdP prompts user for credentials.

4) Correct credentials are supplied.

5) IdP provides SAML artifact (XML) to ID Vault.

6) ID Vault provides ID to Notes. Once Notes session is completed, ID is removed from machine.


SAML – Installation

● Warning! - This is hard!– One of the most complex Domino based things I have seen so far.

● Find help with comprehensive knowledge of:– Domino server admin– Notes client configuration and security– Active Directory configuration at your company– ADFS– SAML concepts– SSL configuration on Domino & in Windows/IIS– Enterprise browser configuration

● It's worth the effort, especially in the long run.

Read the Connect 2014 presentation “SHOW100 : AD+SAML+Kerberos+IBM Notes & Domino = SSO!” by Rob Axelrod and Andy Pedisich, Technotics https://ibm.biz/BdFnyF

https://ibm.biz/BdFnyF


NSL/SPNEGO vs. SAML

● NSL/SPNEGO

● SPNEGO requires Windows Environment

– Active Directory– Windows Domain Login

– Microsoft Supported browsers

– Domino on Windows

● Requires Windows clients for the users

● Citrix not supported

● Requires Domino on Windows

● Has a very specific use case

SAML

● Not everything supports it (yet)

– Traveler doesn’t

– Sametime doesn’t*

– Citrix does!

● ID Vault is a requirement so IDs that can’t be vaulted can’t be used (multiple passwords, smartcards, etc)

● Complex to set up

* Sametime for IBM Verse integration via SAML based SSO https://ibm.biz/BdHqd4


Navigation


● The Quick Win

– ID Vault





● Q & A


Frequently Questioned Answers

Martin LeyrerIBM Collaboration Solutions IT-Specialist with IBM Austria

IBM e-mail: [email protected]

E-mail: [email protected]

Twitter: http://www.twitter.com/leyrer

Facebook: https://www.facebook.com/leyrer

Blog: http://www.leyon.at

LinkedIn: http://at.linkedin.com/in/leyrer



http://www.twitter.com/leyrer

https://www.facebook.com/leyrer

http://www.leyon.at/

http://at.linkedin.com/in/leyrer


Further Reading

“Upgrading from Notes client single logon to Notes shared login” by Nancy E. Khohttps://ibm.biz/BdFnM6

“Single Sign-on (SSO) technologies for the Domino Web Server” by Jane Marcushttps://ibm.biz/BdFnyT

“Connect 2014 SHOW100 : AD + SAML + Kerberos + IBM Notes and Domino = SSO!” by Rob Axelrod and Andy Pedisich, Technoticshttps://ibm.biz/BdFnyF

“Simplifying The S's: Single Sign-On, SPNEGO and SAML” by Gabriella Davishttps://ibm.biz/BdFnfq

https://ibm.biz/BdFnM6

https://ibm.biz/BdFnyT

https://ibm.biz/BdFnyF

https://ibm.biz/BdFnfq


END

Technology

Look Mum, No Passwords!