2. Licensed to Sell:
How to use Atlassian's new Licensing API
to Sell your Plugin on the Atlassian Marketplace
Ben Woskow
Atlassian
Developer, Ecosystem Team
2

3. Overview
• Licensing Introduction
• Plugin Licensing API
• Quick Start Guide
• Under The Hood
• The Bright Future
• UPM 2 Awesomeness
3

4. Licensing Introduction
4

5. The Dark Ages: Vendors
5

6. The Dark Ages: Vendors
Re-implement.
5

7. The Dark Ages: Vendors
Re-implement. Re-test.
5

8. The Dark Ages: Vendors
Re-implement. Re-test. Re-invent.
5

9. The Dark Ages: Vendors
Re-implement. Re-test. Re-invent.
Write a lot of code.
5

10. The Dark Ages: Vendors
HARD
Re-implement. Re-test.
Write a lot of code.
Re-invent.
5

11. The Dark Ages: Vendors
HARD
Re-implement. Re-test.
Write a lot of code.
Re-invent.
6

12. The Dark Ages: Vendors
HARD
Re-implement. Re-test.
Write a lot of code.
Re-invent.
6

13. The Atlassian Marketplace
In-App Experience
• Cheaper, faster, and easier to develop against
• Increases plugin discoverability
• Better experience for your customers
• Improves sales flow
7

14. Plugin Licensing API
8

15. Features
• Validation
• Storage and retrieval
• Encoding and decoding
• Flexible enforcement
9

16. 10

17. Fully Integrated
Billing System
• MyAtlassian (http://my.atlassian.com)
• Communication with license management
• Try, Buy, Renew, and Upgrade workflows
11

18. Compatibility
Confluence 3.1 Dec 2009 27 months
JIRA 4.1 April 2010 23 months
Bamboo 2.6 June 2010 20 months
Fisheye / Crucible 2.4 October 2010 16 months
12

19. 13

20. License Administration UI
• License administration screen allows:
• Updating and removing license
• Viewing license details
• Acquiring a new license from MyAtlassian
• Consistency: all your licensed plugins can
have the same user interface
14

21. Putting the Pieces Together
15

22. Putting the Pieces Together
License
Utilities
15

23. Putting the Pieces Together
License
Compatibility
Utilities
15

24. Putting the Pieces Together
License
Compatibility
Utilities
Billing System
15

25. Putting the Pieces Together
License
Compatibility
Utilities
License
Billing System
Admin UI
15

26. Putting the Pieces Together
License Enforcement
License
Compatibility
Utilities
License
Billing System
Admin UI
15

27. 16

28. Quick Start Guide
17

29. Before You Start
• Decide how to enforce your license
• License enforcement at all plugin entry points
• Use SDK 3.9+: Atlassian-Build-Date
18

30. Licensing Your Plugin
1. Code generation (SDK 3.9+)
• atlas-create-jira-plugin-module
• “Licensing API Support” module
2. Programmatically enforce your license
3. Go eat some chocolate!
19

31. Generated Code
• Maven dependencies
• OSGi bundle instructions
• Uses maven-dependency-plugin
• atlassian-licensing-enabled in plugin-info
• Components and component-imports
• License management servlet
• Sample license enforcement code (optional)
20

32. Under The Hood
21

33. 22

34. Licensing Architecture
23

35. Licensing Architecture
23

36. Licensing Architecture
23

37. Licensing Architecture
23

38. Licensing Architecture
24

39. Licensing Architecture
24

40. 25

41. 25

42. Enforcing a Plugin License
26

43. Enforcing a Plugin License
27

44. 28

45. 28

46. Driving In-App Sales
29

47. Driving In-App Sales
30

48. 31

49. 31

50. EASY
31

51. The Bright Future
32

52. 33

53. Upgrade Path to UPM 2
34

54. Upgrade Path to UPM 2
35

55. Upgrade Path to UPM 2
35

56. 36

57. User Experience
• Without UPM 2:
• Manage each license on own license
administration screen
• With UPM 2:
• Manage all licenses within Plugin Manager
37

58. UPM 2 Awesomeness
38

59. 39

60. 40

61. 41

62. Simple Purchase Path.
41

63. Simple Purchase Path.
Consistent License Management.
41

64. 42

65. 42

66. 42

67. 43

68. 43

69. 44

70. 45

71. Useful Notifications.
45

72. Notifications
• Expired & nearly expired evaluations
• Maintenance expired & nearly maintenance expired
• User mismatch
• Plugin update available
46

73. 47

74. Plugin Branding:
UPM Install Tab

75. Plugin Branding:
UPM Install Tab

78. 50

79. Increased Plugin Discoverability.
50

80. Plugin Discoverability
• Carousel of Marketplace-enabled plugin banners
• Customized branding
• Improved search capabilities
51

81. Plugin Branding
• “Install Plugins” tab
• Plugin Exchange
• “Manage My Plugins” tab
• Plugin artifact (JAR)
52

82. 53

83. 53

84. 54

85. Awesomeness
• Simple purchase path
• Consistent license management
• Useful notifications
• Increased plugin discoverability
55

86. Recap
• Licensing Introduction
• Plugin Licensing API
• Quick Start Guide
• Under The Hood
• The Bright Future
• UPM 2 Awesomeness
56

87. Workshop
• Where: Paris (across the hall)
• When: Today and tomorrow
57

88. Additional Information
• Documentation and tutorials: http://atlss.in/z6X2EW
• Marketplace Workshop
• Ask questions to myself, Jonathan, Daniel, or John
58

89. Thank you!