Add information to your iceScrum items by attaching files from your favorite cloud hosting service.
The iceScrum Cloud storage integration is divided into several Apps, one for each hosting service iceScrum is integrated with. Most of the integration logic is shared among them, that’s why the documentation is unified.
If you use iceScrum Cloud then everything is already configured for you! You can skip to the Usage section.
Otherwise, unlike most Apps, you cannot use cloud integrations on your projects out of the box. First, you must configure the integration in the administration “Settings” view when logged in as the server administrator.
These settings allow you to enable/disable the cloud storage feature for the available services. Connection to these services is done through OAuth so your users don’t have to enter their credentials in iceScrum.
In order to safely integrate iceScrum with a third party service (Dropbox, Google Drive, Microsoft OneDrive and Box), you need to make your iceScrum Server and the corresponding service know each others: the service needs to know your iceScrum server URL and iceScrum needs to know the application API Key.
This API requires creating credentials of two types.
Start by creating API key credentials. You can optionally restrict the use of this API key to the domain of your iceScrum server.
OAuth client ID
Create new credentials of type OAuth client ID. You need to create a consent screen that will be displayed to your users when first connecting iceScrum to their Drive account, just give it a name, e.g. “iceScrum”, and save.
Finally, open the iceScrum administration settings, enable the Google Drive integration and can enter the Client ID and API Key you obtained in the previous steps.
Create a new Custom App and choose Standard OAuth 2.0 (User Authentication).
Open the Configuration panel and copy the provided Client ID.
Finally, open the iceScrum administration settings, enable the Box integration and enter the Client ID you obtained.
As an alternative to built-in connection to Cloud hosting services, you can enter the URL of a remote media manually. That allows you to attach files from your intranet or services without dedicated integration with iceScrum. There is no configuration needed, just enable the App!
If possible, iceScrum will fetch the name of the media you want to add and even display a preview. Here is a list of the services that provide previews: YouTube, SlideShare, Speaker Deck, Meetup, Codepen, Dropbox Paper, Dailymotion, Figma, Facebook, Instagram, SoundCloud, Flickr, Brightcove, Hulu, Scribd, Viddler, Vimeo, SmugMug, Mixcloud, Coub, Funny or Die, Wistia, IFTTT, carto.com, Widgetic, Reddit, Graphiq, Slidely, Getty Images, Twitter, Droplr, Adobe Stock, Adobe XD, Marvel, Spotify, Twitch, Office Forms, Tapewrite, someecards, Datawrapper, Airtable, Pastebin, Framer, Gist Github, Lucidchart, Imgur, Glycat, Pinterest, Infogram, Screen9, Screencast, Screenr, ScribbleMaps…
Once the administration is configured, you should be able to enable the App corresponding to the service you want to integrate with on your project. Just like regular attachments, cloud ones can be added at the project, release, sprint, feature, story and task levels. Once your App is enabled, the cloud attachment icon will be available next to the attachment button.
Click on the icon corresponding to your Cloud service to attach files it contains. If you are not logged in on your you will have to enter your credentials directly in the cloud service. Once you are authenticated, a file picker allows to pick the file you want to attach.
If you use manual URLs, enter the associated URL with the appropriate scheme (e.g. smb:// for a samba server).
The integration is transparent so uploaded and cloud attachments from the different services will appear at the same place.