<style>p { margin: 0; }span.fr-emoticon.fr-emoticon-img { background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle; } span.fr-emoticon { font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0; } blockquote { border-left: solid 2px #5e35b1; color: #5e35b1; margin-left:0; padding-left:5px;}blockquote blockquote{ border-color: #00bcd4; color: #00bcd4;}blockquote blockquote blockquote{ border-color: #43a047; color: #43a047;} table.grid{ border-collapse: collapse;} table.grid td, table.grid th { border: 1px solid #ddd;} .fr-fic.fr-dib{ display: block; margin: 5px auto;}.fr-fic.fr-dib.fr-fir{ text-align: right; margin: 5px 0 5px auto;}.fr-fic.fr-dib.fr-fil{ text-align: left; margin: 5px auto 5px 0;}.fr-fic.fr-dii{ float: none; margin: 5px auto;}.fr-fic.fr-dii.fr-fil{ float: left; margin: 5px auto;}.fr-fic.fr-dii.fr-fir{ float: right; margin: 5px auto;}img.fr-dib.fr-fir { margin-right: 0; text-align: right;}img.fr-dib.fr-fil { margin-left: 0; text-align: left;}img.fr-dib { margin: 5px auto; display: block; float: none;}img.fr-bordered { box-sizing: content-box; border: solid 5px #CCC;}img.fr-shadow { box-shadow: 10px 10px 5px 0px #cccccc;}img.fr-rounded { border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;}</style><style>
p {
margin: 0;
}
span.fr-emoticon.fr-emoticon-img {
background-repeat: no-repeat !important; font-size: inherit; height: 1em; width: 1em; min-height: 20px; min-width: 20px; display: inline-block; margin: -0.1em 0.1em 0.1em; line-height: 1; vertical-align: middle;
}
span.fr-emoticon {
font-weight: normal; font-family: "Apple Color Emoji", "Segoe UI Emoji", "NotoColorEmoji", "Segoe UI Symbol", "Android Emoji", "EmojiSymbols"; display: inline; line-height: 0;
}
blockquote {
border-left: solid 2px #5e35b1; color: #5e35b1; margin-left: 0; padding-left: 5px;
}
blockquote blockquote {
border-color: #00bcd4; color: #00bcd4;
}
blockquote blockquote blockquote {
border-color: #43a047; color: #43a047;
}
table.grid {
border-collapse: collapse;
}
table.grid td,
table.grid th {
border: 1px solid #ddd;
}
.fr-fic.fr-dib {
display: block; margin: 5px auto;
}
.fr-fic.fr-dib.fr-fir {
text-align: right; margin: 5px 0 5px auto;
}
.fr-fic.fr-dib.fr-fil {
text-align: left; margin: 5px auto 5px 0;
}
.fr-fic.fr-dii {
float: none; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fil {
float: left; margin: 5px auto;
}
.fr-fic.fr-dii.fr-fir {
float: right; margin: 5px auto;
}
img.fr-dib.fr-fir {
margin-right: 0; text-align: right;
}
img.fr-dib.fr-fil {
margin-left: 0; text-align: left;
}
img.fr-dib {
margin: 5px auto; display: block; float: none;
}
img.fr-bordered {
box-sizing: content-box; border: solid 5px #CCC;
}
img.fr-shadow {
box-shadow: 10px 10px 5px 0px #cccccc;
}
img.fr-rounded {
border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -moz-background-clip: padding; -webkit-background-clip: padding-box; background-clip: padding-box;
}
</style><p><strong>In this guide we will cover:</strong></p><p><strong>- What is the StreamOne Ion Integration?</strong></p><p><strong>- OAuth Credentials</strong></p><p><strong>- Configuring the Integration</strong></p><p><strong>- Customers</strong></p><p><strong>- Subscriptions</strong></p><p><br></p><p><br></p><p><strong>Related Guides:</strong></p><ul><li style="font-weight: bold;"><a href="https://usehalo.com/halopsa/guides/2508" target="_blank" rel="noopener noreferrer"><strong>Licences/Subscriptions Overview</strong></a></li></ul><p><br></p><p><strong><span style="font-size: 14pt;">What is the StreamOne Ion Integration?<br></span></strong></p><p>The StreamOne Ion integration can be used to import your customers and subscriptions as well as update customers licenses on a recurring schedule via the Halo Integrator.</p><p><br></p><p><strong><span style="font-size: 14pt;">OAuth Credentials</span></strong></p><p>To begin integrating, sign in to your StreamOne Ion account (<a href="https://ion.tdsynnex.com/" target="_blank">https://ion.tdsynnex.com</a>) and fill in the OAuth Credentials By going to the following settings.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImNlNzRlOTI4LTQ2OTMtNDYxZi1hNjI0LWI1YmQyYzZlMTE1ZiJ9.aafItPPMPCQAThzulyn4tbG3qx36QgFzU_5rxo5beJE" class="fr-fic fr-fil fr-dib" width="884" height="564"></p><p><strong><span style="font-size: 10pt;">Fig 1. Account information.</span></strong></p><p><br></p><p>OAuth credentials can be created for any user within your StreamOne Ion account that has the 'Account Admin' user role.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImY0MDMxZDAyLWM0YzktNGI5ZC1hMTUwLWNmM2M5YTczNzJmZCJ9.cWpGqX6vzGchkcsQ0yEuSbMjGUwUp4g473vrMJcIL_8" class="fr-fic fr-fil fr-dib" width="1207" style="width: 1209px; height: 685.83px;" height="686"></p><p><strong><span style="font-size: 10pt;">Fig 2. OAuth credentials.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Configuring the Integration</span></strong></p><p>To begin configuring the Integration in Halo, head over to Configuration > Integrations > Distribution/search for StreamOne, make sure to click the "+" button on the module.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImI5OWRjNjM5LWJiMTUtNDdjZS1iZDRlLWUyNTA3OTJiOGIxYyJ9.Kb_LyQlHJ5FVKsAZcvPIJfXMuUU1mKhhQLFVvbVkBDs" class="fr-fic fr-fil fr-dib" width="672" height="307"></p><p><strong><span style="font-size: 10pt;">Fig 3. Enabling the module.</span></strong></p><p><br></p><p>After clicking into the module and clicking new (top right hand side) to create a new account, the credentials from StreamOne Ion can be entered into the integration page on Halo.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjhiNzM0YTEwLWI3M2UtNDMxNC05NTI4LWVjN2I2MGI2ZTI0YSJ9.L-q_MJe14Jdk8o9IqkNe4_qB_iEFR-s8dF80obwoKBk" class="fr-fic fr-fil fr-dib" width="1214" style="width: 1216px; height: 209.242px;" height="209"></p><p><strong><span style="font-size: 10pt;">Fig 4. Setup.</span></strong></p><p><br></p><p id="isPasted">The Test Configuration button on the integrations page tests whether the Halo API can connect to the StreamOne Ion API. If successful, a modal screen will appear with the note "Test successful"</p><p><br></p><p><strong><em>Note: StreamOne Ion refresh tokens have a 30 day lifespan, this means the token will expire after 30 days, at which point a new one will need to be generated and entered into Halo. </em></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Customers</span></strong></p><p>Customers can be mapped and imported from StreamOne Ion. Mappings can be set up manually through adding mappings to the table, or through the generate mapping button, mappings will only generate if the customer in Halo matches the exact name of the customer in StreamOne Ion. Customer imports can be done through the UI or the Halo Integrator.</p><p><br></p><p>When importing customers from StreamOne Ion that do not have a mapping set up they will be attempted to be matched based on their customer UID. if they cannot be matched a new customer will be created.</p><p><br></p><p>There are further options to choose a top level for imported customers if top levels are enabled (Configuration > Users > General Settings) and more than one top level is in use. There is also an option to update the main site address of existing customers "imported" via this integration.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6ImMyMmE2NmIwLWJlMGYtNDc5Ni1hZWM2LTBmZjg0Yjc0ODZjZCJ9.6Ggny0PCTKSHt4TYbXOCj9swDc-Sf_1izjxqqHxYXs0" class="fr-fic fr-fil fr-dib" width="965" height="171"></p><p><strong><span style="font-size: 10pt;">Fig 5. Customer configuration.</span></strong></p><p><br></p><p><strong><span style="font-size: 14pt;">Subscriptions</span></strong></p><p>Subscriptions can be imported for any mapped customer either manually or via the Halo Integrator.</p><p><br></p><p><img src="https://halo.haloservicedesk.com/api/attachment/image?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6Ijg4ODI5OTJmLTMxOWMtNGVlZi04OTc0LTM3YWUxY2E4ZDU2NyJ9.jsxunPHNly1eSovxUsM3HuoX2zcUyg9Cvj8pA5mGP54" class="fr-fic fr-fil fr-dib" width="1195" height="565"></p><p><strong><span style="font-size: 10pt;">Fig 6. Subscription configuration and integrator.</span></strong></p>
