===== Workdocs =====

== Documentation ==


Developer docs, needed to implement a **custom app**, 
which will interact with documents in WorcDocs.

https://docs.aws.amazon.com/pdfs/workdocs/latest/developerguide/workdocs-dg.pdf

== Example of an authentication flow for custom app ==

Create a "Workdocs Site" with a valid user

  * login: ''myworkdocsuser@gmail.com''
  * password: ''???''

Create a "AWS My application" here with 
  * ID ''b92764b9-0591-460d-9b66-9c5615ccfff9''


Deploy some custom Web-App, which would work with "Workdocs" files and need a access_token for that:

  * URL e.g. : ''http://www.heremycustomwebapptoreceiveaccesstoken.com/''


==Step1== 

Redirect the user, who is supposed to allow access to his workdocs files

Use URL ''https://auth.amazonworkdocs.com/oauth?app_id=b92764b9-0591-460d-9b66-9c5615ccfff9&auth_type=ImplicitGrant&redirect_uri=http://www.heremycustomwebapptoreceiveaccesstoken.com''

As described in https://docs.aws.amazon.com/pdfs/workdocs/latest/developerguide/workdocs-dg.pdf

{{https://s3.eu-central-1.amazonaws.com/alf-digital-wiki-pics/sharex/KbnMJAVT7u.png?600x250}}

==Step2==

As a WorkDocs user I do login into the application, to approve the usage of my files by the app.

{{https://s3.eu-central-1.amazonaws.com/alf-digital-wiki-pics/sharex/K6mnA5wRTF.png?600x250}}

==Step3==



{{https://s3.eu-central-1.amazonaws.com/alf-digital-wiki-pics/sharex/GNGulovcfP.png?600x250}}

==Step4==

Finally I am redirected to my web-app for the URL I have passed earlier (and registered in the "my applications")

{{https://s3.eu-central-1.amazonaws.com/alf-digital-wiki-pics/sharex/MxVYfCEgC4.png?700x350}}