# Creating your First Integration

(REF: ONBOARDING PAGE AND MANIFEST INSTRUCTIONS PAGE)

[Onboarding](/docs/on-boarding-to-iics.md)
[Manifest](/docs/manifest-users.md)

## Gaining Access to IICS

One will be unable to use any practical functionality in IICS until they have an IICS account with permissions applied to it. Acquiring this account is dependent on contacting the IICS administrators. This process is outlined on our [Onboarding Page](/docs/on-boarding-to-iics.md)

If you are following along with this tutorial, you most likely will have already started the process of accessing the IICS service. The steps of this process will be hosted on this page as a quick reference, however.

1. Create a Manifest Group, and add all related personell who will be using IICS (including yourself). 
	- For documentation on how to create a Manifest Group, click [Here](https://kb.wisc.edu/page.php?id=25878).
	- For documentation on how to add users to a Manifest Group, click [Here](https://kb.wisc.edu/page.php?id=25882).
	- Manifest Groups must be created within a folder. For documentation on the process of creating a folder, click [Here](https://kb.wisc.edu/page.php?id=27783).
	- As an alternative to this first step, if your team already has a Manifest Group, that may be used.
		- If this Manifest Group is already used to provision access to IICS, you may skip to step 5.
2. Grant our team at uw:org:ais:ais-admins Read and View permissions to your group.
	- We will be unable to view your group or apply the automated IICS account provisioning unless you do this.
	- For documentation on this process, click [Here](https://kb.wisc.edu/25880).
3. Contact our Team so that we can apply the correct permissions to your Manifest Group.
	- IICS automatically sets up accounts for any users in Manifest Groups with specified permissions, but those permissions must be set up by us.
	- There may be some delay on this step, although the turnaround should be no more than 1-2 business days. Our team will contact you once this step has been completed.
	- Note that the process of gaining access to IICS involves filling out a formal request. Information on this process can be found [Here](/docs/on-boarding-to-iics.md).
5. Log in to IICS. Information on how to log in can be found [Here](/docs//logging-in.md).
	- IICS has two orgs associated with it - test and prod. It is heavily reccomended that you log in to both, as to make sure your account exists within the system.
	- If you intend to change org on the same browser, it is heavily reccomended that you manually log out by clicking the "log out" button on the top right of the homepage or under the profile tab of the top bar on any other page. 
	- If you fail to log out, IICS will fail to change organizations when logging in using a different link.
6. Contact our Team so that we can apply correct permissions to you.
	- If you are working alongside multiple team members it is reccommended that all team members are logged in before you contact us, so we can provide permissions for everyone in one round of communication.

## Gaining Access to PersonAPI

Access to IICS requires admin intervention
Access to IICS needs a manifest group created
	Folder is needed, old OR new
	Manifest group needs to be made
	users need to be added to the manifest group
	uw:org:ais:ais-admins NEEDS read & view priveleges on aformentioned group
Once group is set up, admins will give you and IICS account
	admin gives IICS access
	you log in
		log into test
		press LOG OUT
		log into prod
		press LOG OUT
	admin gives permissions within iics
(REF: PERSONAPI DOCS)

## Gaining Access to PersonAPI

[Person API Docs](https://developer.wisc.edu/get-started)
[Postman](https://www.postman.com/)

Provision Access to PersonAPI
	NOTE: requires access to developer.wisc.edu and THUS a netid. is this something everyone will have?
	Sign in
	Register Application
	Enable Mock Person API
	Acquire API Key (both access AND secret)
Auth in Postman
	Set Auth to OAuth 2.0
	Configure new token - Grant Type of Client Credentials
	Access Token URL of https://api.wisc.edu/oauth/token
	ID and Secret of Token equal to Key and Secret of API Key
	Click "Get Access Token"
Test in Postman
	GET request to https://mock.api.wisc.edu/people
	should see several records