Hands-on opportunity to build your own plug-in, using the PingAccess 3.0 SDK, to solve your Web Application/API Access Management challenges, and walk away with a an evaluation copy of the Ping Identity WAM solution and the custom plug-in that you built.

2. BUILDING A PLUG-IN WITH
THE PINGACCESS SDK
Jason Musgrave
Senior Software Engineer
Copyright © 2014 Ping Identity Corp.All rights reserved. 2

3. Me
Copyright © 2014 Ping Identity Corp.All rights reserved. 3
Image:Apple II tranparent 800 / CC-BY-SA-2.0-fr / Devin Cook (editing) Rama & Musée Bolo - Own work

4. Web & API Access Management
Copyright © 2014 Ping Identity Corp.All rights reserved. 4

5. APIs vs SDKs
Copyright © 2014 Ping Identity Corp.All rights reserved. 5

6. APIs vs SDKs
Copyright © 2014 Ping Identity Corp.All rights reserved. 6

7. Tooling
Copyright © 2014 Ping Identity Corp.All rights reserved. 7
• Java 7 (or 8)
• Git 1.8.x
• Maven 3.x

8. Via Maven
http://maven.pingidentity.com/release/
Copyright © 2014 Ping Identity Corp.All rights reserved. 8
How to access?
Via the Install
{PA-INSTALL-PATH}/sdk/samples/
README.md
<dependency>
<groupId>com.pingidentity.pingaccess</groupId>
<artifactId>pingaccess-sdk</artifactId>
<version>3.0.0</version>
</dependency>

9. Flashdrive
Copyright © 2014 Ping Identity Corp.All rights reserved. 9
• Clone of Git Repo
– Markdown Instructions
– Sample
• PingAccess
– SDK
• License
• demo-simple-webapp

10. Git repo before / after
Copyright © 2014 Ping Identity Corp.All rights reserved. 10
https://github.com/pingidentity/CIS-2014-PingAccess-3.0-SDK-Demo
• Branches
– master
– BEGIN
– RENDERUI
– CONFIGURE

11. What’s in the SDK?
Copyright © 2014 Ping Identity Corp.All rights reserved. 11
SDK
Transactional
Rule Site Authenticator
UI
Render HttpConfig UserData

12. Http?
Copyright © 2014 Ping Identity Corp.All rights reserved. 12
What about
javax.servlet.http.HttpServletRequest?

13. Copyright © 2014 Ping Identity Corp.All rights reserved. 13
com.pingidentity.pa.sdk.http
Request
Response
Exchange
Header
HeaderFields
Body
Header
HeaderFields
Body

14. What’s A Rule?
Copyright © 2014 Ping Identity Corp.All rights reserved. 14

15. What’s A Rule?
Copyright © 2014 Ping Identity Corp.All rights reserved. 15

16. What
Copyright © 2014 Ping Identity Corp.All rights reserved. 16

17. Describe
Copyright © 2014 Ping Identity Corp.All rights reserved. 17

18. Save
Copyright © 2014 Ping Identity Corp.All rights reserved. 18

19. Describe / Configure / Validate
Copyright © 2014 Ping Identity Corp.All rights reserved. 19
• Describe à Annotations or Builder
– com.pingidentity.pa.sdk.ui.UIElement
– com.pingidentity.pa.sdk.ui.ConfigurationBuilder
• Configure à Jackson Mapping and Lifecycle methods.
• Validate à javax.validation.Constraint

20. Describe / Configure / Validate
Copyright © 2014 Ping Identity Corp.All rights reserved. 20

21. Execute: handleRequest / handleResponse
Copyright © 2014 Ping Identity Corp.All rights reserved. 21

22. DEMO
PingAccess SDK
Copyright © 2014 Ping Identity Corp.All rights reserved. 22

23. git checkout BEGIN
Copyright © 2014 Ping Identity Corp.All rights reserved. 23

24. Annotate Rule
Copyright © 2014 Ping Identity Corp.All rights reserved. 24

25. Build Configuration Class
Copyright © 2014 Ping Identity Corp.All rights reserved. 25

26. ConfigurationBuilder from()
Copyright © 2014 Ping Identity Corp.All rights reserved. 26

27. Expected Configuration
Copyright © 2014 Ping Identity Corp.All rights reserved. 27

28. Configure & Initialization
Copyright © 2014 Ping Identity Corp.All rights reserved. 28

29. Handle Request
Copyright © 2014 Ping Identity Corp.All rights reserved. 29

30. Error Callback
Copyright © 2014 Ping Identity Corp.All rights reserved. 30