Области разрешений

Разрешения Power BI дают приложению возможность выполнить определенные действия от имени пользователя. Все разрешения должны быть утверждены пользователем, чтобы быть допустимыми.

Отображаемое имя Описание Значение области
Просмотр всех наборов данных Приложение может просматривать все наборы данных для пользователя, выполнившего вход, и наборы данных, к которым пользователь имеет доступ. Dataset.Read.All
Чтение и запись всех наборов данных Приложение может просматривать и осуществлять запись во все наборы данных для пользователя, выполнившего вход, и наборы данных, к которым пользователь имеет доступ. Dataset.ReadWrite.All
Добавление данных к набору данных пользователя (предварительная версия) Предоставляет приложению доступ для добавления или удаления строк набора данных пользователя. Это разрешение не предоставляет приложению доступ к данным пользователя. Data.Alter_Any
Создание содержимого (предварительная версия) Приложение может автоматически создавать содержимое и наборы данных для пользователя. Content.Create
Просмотр групп пользователя Приложение может просмотреть все группы, к которым принадлежит пользователь, выполнивший вход. Group.Read
Просмотр всех групп Приложение может просмотреть все группы, к которым принадлежит пользователь, выполнивший вход. Group.Read.All
Просмотр всех информационных панелей (предварительная версия) Приложение может просматривать все информационные панели для пользователя, выполнившего вход, и информационные панели, к которым пользователь имеет доступ. Dashboard.Read.All
Просмотр всех отчетов (предварительная версия) Приложение может просматривать все отчеты для пользователя, выполнившего вход, а также отчеты, к которым у него есть доступ. Приложение также видит данные в отчетах и их структуру. Report.Read.All
Чтение и запись всех отчетов Приложение может просматривать и осуществлять запись во все отчеты для пользователя, выполнившего вход, и отчеты, к которым пользователь имеет доступ. Это не предоставляет права на создание отчета. Report.ReadWrite.All

Приложение может запрашивать разрешения, когда впервые пытается войти на страницу пользователя, передавая запрошенные разрешения в параметре области вызова. Если разрешения предоставлены, возвращается маркер доступа для приложения, который может использоваться в дальнейших вызовах API. Доступ может использоваться конкретным приложением.

Примечание.

В интерфейсах API Power BI рабочие области приложения по-прежнему называются группами. Если упоминаются группы, это означает, что вы работаете с рабочими областями приложения.

Запрос разрешений

Хотя можно вызвать API для аутентификации по имени пользователя и паролю, чтобы выполнять действия от имени другого пользователя, необходимо будет запрашивать разрешения, которые затем подтверждает пользователь, после чего отправлять полученный маркер доступа во всех последующих вызовах. Для этого процесса мы будем следовать стандартному протоколу OAuth 2.0. Хотя фактические реализации могут отличаться, процесс OAuth для Power BI содержит следующие элементы:

  • Пользовательский интерфейс входа — это пользовательский интерфейс, который разработчик может вызвать для запроса разрешений. Пользователю потребуется войти, если это еще не сделано. Также ему потребуется утвердить разрешения, которые запрашивает приложение. Окно входа в систему вернет код доступа или сообщение об ошибке на указанный URL-адрес перенаправления.
    • Стандартный URL-адрес перенаправления должен предоставляться Power BI для использования собственными приложениями.
  • Код авторизации — коды авторизации возвращаются веб-приложениям после входа в систему через параметры URL-адреса в URL-адресе перенаправления. Так как они указываются в параметрах, существует определенный риск безопасности. Веб-приложениям потребуется обменять код авторизации на маркер авторизации.
  • Маркер авторизации — используется для проверки подлинности вызовов API от имени другого пользователя. Они будут выдаваться для определенного приложения. У маркеров есть заданное время существования, и после его окончании их необходимо будет обновить.
  • Обновление маркера — когда срок действия маркера истекает, выполняется процесс его обновления.

Появились дополнительные вопросы? Попробуйте задать вопрос в сообществе Power BI.