Org Web Adapter

Editing pages/15five_project_app_library.org

:PROPERTIES:
:ID:       49a1eb19-1b65-493a-b321-81c164a64cfc
:ROAM_ALIASES: "App Library"
:END:
#+title: 15Five Project: App Library

- tags :: [[id:b08ac197-337b-4392-84d5-98eaead61400][15Five]] [[id:e273e0ee-4ce6-4cb3-b967-51d378ede2da][Project]] [[id:fc2649a7-dba7-47f8-bef3-caabb8710e5a][Partnership]]

* Partner App Guide
** Brief
This document provides an outline for having a discussion with a prospective App Library partner. It provides initial questions, suggestions for follow up questions, as well as the capabilities and limitations of our current App Library.
** Questions
*** Phase 1 Questions for SSO

The goal with these initial questions is to find out how easy an initial SSO integration would be. If the answer to #2 is 'yes', initial SSO integration can be handled by support via the document for adding a new partner app to the App Library (link coming soon).

If they answer 'no' to #2 and 'yes' to #3, an SSO integration is possible, but will likely require engineering work to be fully functional.

1. Can you provide us with an organization-level sandbox account within your app?
2. Do you support common Identity Providers (e.g. Okta, Azure, OneLogin) using subdomains?
3. Do you provide JWT token access to your platform with automated user-provisioning for new users?
4. Can you provide a list customer names hashed via MD5 (or some other mechanism) for finding mutual customers?

*** Phase 2 Questions for Deeper Integration

The goal with deeper integration questions is to begin exploring how 15Five and the partner can exchange data and what each party hopes to get out of the integration. It's possible that for many partners, aside from user provisioning, there will not be a lot more do.

1. Can you provide a demo of the capabilities of your application (recorded or live)?
2. Can you provide documentation of the API capabilities of your platform along with authentication methods?
3. Can you provide us a brief description of what you hope to achieve with a 15Five app integration?
4. What data would you need from 15Five to accomplish an integration within your platform, and/or have you reviewed our API documentation?

* User stories
** As a company admin, I want to browse available partner apps that I might like my company users to login to with single-sign-on
** As a company admin, I want to see more information about what a partner app provides to my company users and the credentials I will need to setup single-sign-on with my 15Five account
** As a company admin, I want to enable an "app" to allow my company users to login with single-sign-on from within 15Five
** As a non-admin user, I would like easy access to partner apps with SSO enabled so that I can quickly login to the partner app from within the 15Five application
** As a non-admin user, I would like to see  more information about a partner app before I login with SSO