Integrations

on this page users can create and manage their data integrations it is possible to set up data integrations with your cloud buckets, which allows you to import data (scenes and pre annotations) to the kognic platform without having to upload it from your local machine after setting up a data integration, it is possible to use kognic io to import data from the specified bucket supported cloud storage providers right now it is possible to set up data integrations with the following cloud storage providers google cloud platform (gcs) amazon web services (s3) if you are using a different cloud provider that you would like to set up a data integration with, reach out to your kognic contact create a new integation to set up a new integration, click on create new integration follow the steps below depending on which cloud provider you will set up the integration with note that the guides below walk you through the process of giving kognic read access to one of your cloud buckets google cloud platform (gcs) choose cloud provider select the option google cloud platform provide bucket information in gcp, navigate to the bucket you want to integrate with copy the bucket’s name and paste it in the name field grant service account access in the kognic platform, copy the kognic service account number in gcp, within the bucket’s permission tab, click grant access and paste the service account number as a new principal and assign the role storage object viewer finalize setup in kognic, click create integration in the bottom right corner amazon web services (s3) choose cloud provider select the option amazon web services provide bucket information in this step you need to provide the name and aws region of the bucket you will integrate with a) specify bucket name in aws, navigate to the bucket you want to integrate with copy the bucket’s name and paste it in the name field in kognic b) specify aws region for the same bucket, specify it’s aws region, e g eu north 1, in the aws region field in kognic create a role for kognic in aws next, you need to set up a role for kognic in aws and give it s3 read access to your bucket a) create a new role in aws in aws, navigate to identity and access management (iam) , select roles and click on create role for trusted entity type select custom trust policy copy the trust policy from the kognic platform, go back to aws and paste it in the custom trust policy section click next and skip the permissions step for now by clicking next again give your role a descriptive name and click the create role button b) specify the role arn in aws, click on the role you just created and copy the amazon resource name (arn) paste it in the role arn field in kognic c) give the role s3 read access in aws, for the role that you just created, scroll down to the permission policies section and click on add permissions followed by create inline policy copy the inline policy from the kognic platform, head back to aws and in the policy editor, click on json and paste the policy click on next, give the policy a name and click create policy finalize setup in kognic, click create integration in the bottom right corner test your integation when an integration has been created you can test if it works by following the steps below find the integration you want to test in the kognic platform, locate the integration you want to test in the integrations table click on the three dots next to it and in the subsequent context menu click run a test find and copy an object's uri in gcp navigate to the bucket and open it next to any folder of file, click the three dots and in the subsequent context menu click copy gsutil uri in aws navigate to the bucket and open it click on a file to open it and then click on copy s3 uri run integration test go back to the kognic platform and paste the object uri into the "uri" field in the dialog window click test integration if test was successful, you will get a success message and can click on ok, i got it! the test status value will change to "successful" in the table if the test fails you an notification will appear with an error message that you can use for debugging use your integation now you're all set up to start creating scenes using external resources read more about how to this in our docid\ aewtqkrztf5zoo5sasydv