Permissions

To use features like the clipboard, location information, photo album, and contacts in the app, you need to set permissions. This guide explains how to set permissions so these features can be used in the Toss app.

WebView environment Web API

In the WebView environment, the use of general web APIs is not restricted. Therefore, you can use most standard Web APIs available in the browser in the same way.

Permission list

Below is a list of permission names and allowed actions. Also check the access value for each permission.

Camera

• Permission name: camera
• Access(access): openCamera

Album

• Permission name: photos
• Read(read): fetchAlbumPhotos

Clipboard

• Permission name: clipboard
• Read(read): getClipboardText
• Write(write): setClipboardText

Contacts

• Permission name: contacts
• Read(read): fetchContacts

Location

• Permission name: geolocation
• Access(access): startUpdateLocation, getCurrentLocation, useGeolocation

Microphone

• Permission name: microphone
• Access(access): Will be supported later. If this is WebView, please implement it directly using the Web API.

Set permissions

The permissions used in the app can be granite.config.tsdefined in . This is used when reviewing the app. Permission listPlease refer to it and configure it.

The following is an example configured to use the clipboard, camera, and photo album.

React Native

import { appsInToss } from '@apps-in-toss/framework/plugins';
import { defineConfig } from '@granite-js/react-native/config';

export default defineConfig({
  appName: '<my-service-name>',
  plugins: [
    appsInToss({
      permissions: [
        {
          name: 'clipboard',
          access: 'read',
        },
        {
          name: 'clipboard',
          access: 'write',
        },
        {
          name: 'camera',
          access: 'access',
        },
        {
          name: 'photos',
          access: 'read',
        },
      ],
    }),
  ],
});

WebView

import { defineConfig } from '@apps-in-toss/web-framework/config';

export default defineConfig({
  appName: '<my-service-name>', // App name set in the Apps in Toss console
  web: {
    /* Existing settings */
  },
  permissions: [
    {
      name: 'clipboard',
      access: 'read',
    },
    {
      name: 'clipboard',
      access: 'write',
    },
    {
      name: 'camera',
      access: 'access',
    },
    {
      name: 'photos',
      access: 'read',
    },
  ],
});