Rejestracja identyfikatora klienta drukarki universal print (UP)

Wymagane uprawnienia interfejsu API aplikacji klienckiej drukarki OEM

Usługa Universal Print obsługuje token dostępu autoryzacji OAuth2 wystawiony przez platformę Azure. Utworzenie drukarki gotowej do drukowania uniwersalnego wymaga, aby producenta OEM zarejestrowało aplikację kliencką na platformie Azure z wymaganym zestawem uprawnień. Protokół OAuth2 definiuje 2 typy żądań uprawnień .

Uprawnienia zakresu delegowanego

Scope	Ciąg wyświetlania	opis	Wymagana zgoda administratora
Drukarki.Create	Utwórz i zarejestruj nową drukarkę.	Umożliwia aplikacji tworzenie i rejestrowanie drukarki w imieniu zalogowanego użytkownika.	Tak

Uprawnienia zakresu aplikacji

Scope	Ciąg wyświetlania	opis	Wymagana zgoda administratora
Drukarki.Read	Odczytywanie drukarek, do których konto ma dostęp.	Umożliwia aplikacji odczytywanie drukarek bez zalogowanego użytkownika.	Tak
PrinterProperties.ReadWrite	Odczytywanie i zapisywanie właściwości i atrybutów drukarki, do których konto ma dostęp.	Umożliwia aplikacji odczytywanie i zapisywanie właściwości i atrybutów drukarki bez zalogowanego użytkownika.	Tak
PrintJob.ReadWriteBasic	Odczytywanie i zapisywanie metadanych zadania drukowania.	Umożliwia aplikacji odczytywanie i zapisywanie metadanych zadań drukowania użytkowników bez zalogowanego użytkownika.	Tak
PrintJob.Read	Odczytaj metadane i ładunek zadania drukowania.	Umożliwia aplikacji odczytywanie metadanych i ładunków zadań drukowania użytkowników bez zalogowanego użytkownika.	Tak

Rejestracja aplikacji klienckiej drukarki OEM

1. Utwórz aplikację wielodostępną przy użyciu dzierżawy tworzenia aplikacji w firmie.
2. Skonfiguruj aplikację z wieloma dzierżawami, aby zażądać wymaganego zestawu zakresów uprawnień zgodnie z definicją powyżej.
   • Printers.Create [Delegowane]
   • Drukarki.Read [Aplikacja]
   • PrinterProperties.ReadWrite [Aplikacja]
   • PrintJob.ReadWriteBasic [Aplikacja]
   • PrintJob.Read [Aplikacja]

Rejestrowanie nowej aplikacji

Kopiowanie zarejestrowanego identyfikatora aplikacji do późniejszego użycia

Ustawianie ustawienia uwierzytelniania aplikacji

Dodawanie wymaganych uprawnień interfejsu API przy użyciu witryny Azure Portal

Po kliknięciu przycisku "Dodaj uprawnienie" po prawej stronie zostanie wyświetlone okno wysuwane. W oknie wysuwanym wybierz pozycję "Interfejsy API firmy Microsoft".

Prawdopodobnie trzeba będzie przewinąć w dół w oknie wysuwaym, aby znaleźć "Universal Print"

Dodaj uprawnienia wymienione powyżej.

Po dodaniu wymaganych uprawnień uprawnienia aplikacji powinny wyglądać następująco:

Jeśli szukasz innego sposobu konfigurowania uprawnień interfejsu API, zobacz "Alternatywna opcja ".

Aktualizowanie wydawcy aplikacji klienckiej drukarki OEM

Domyślnie zarejestrowana aplikacja będzie mieć wydawcę "niezweryfikowanego". Jeśli pozostanie bez zmian, klienci zobaczą komunikat "niezweryfikowane" w oknie dialogowym zgody na uprawnienia. Postępuj zgodnie z instrukcjami : konfigurowanie domeny wydawcy aplikacji w celu ustawienia wydawcy aplikacji.

Aby uzyskać szybką dokumentację, podstawowe kroki to:

Uwaga

Po zintegrowaniu tego identyfikatora aplikacji klienckiej drukarki z kodem uruchomionym na drukarce po raz pierwszy drukarka używająca tego identyfikatora jest rejestrowana w usłudze Universal Print w dzierżawie klienta, Administracja istrator zostanie poproszony o wyrażenie zgody na tę aplikację.

Po zaktualizowaniu domeny wydawcy do zweryfikowanej domeny okno dialogowe zgody żądania uprawnień aplikacji wyświetli zweryfikowaną wartość domeny.

Przykładowe żądanie uwierzytelniania urządzenia OAuth 2.0

Po wykonaniu powyższych kroków możesz poprosić o zweryfikowanie, wysyłając żądanie HTTP POST na https://login.microsoftonline.com/organizations/oauth2/v2.0/devicecode adres z składnią treści HTTP

• client_id={registered printer client ID}&scope=https%3A%2F%2Fprint.print.microsoft.com%2F.default

POST https://login.microsoftonline.com/organizations/oauth2/v2.0/devicecode HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Host: login.microsoftonline.com

client_id=3e41cb36-3180-4566-bf3d-51ec873419e5&scope=https%3A%2F%2Fprint.print.microsoft.com%2F.default

Alternatywna opcja dodawania wymaganych uprawnień interfejsu API

1. Znajdź requiredResourceAccess sekcję w manifeście
2. Skopiuj i wklej następujące wymagane uprawnienia interfejsu API do manifestu. Najprostszym sposobem jest zastąpienie całej requiredResourceAccess sekcji manifestu.

"requiredResourceAccess": [
    {
        "resourceAppId": "da9b70f6-5323-4ce6-ae5c-88dcc5082966",
        "resourceAccess": [
            {
                "id": "3e306194-d6c5-43ad-afbb-0e7b16a9c10b",
                "type": "Scope"
            },
            {
                "id": "1c90a3a7-465b-49c4-adcc-c8ac83d3d3f8",
                "type": "Role"
            },
            {
                "id": "2b1bdd6b-9a0f-47c6-a806-b3e20cfd07a8",
                "type": "Role"
            },
            {
                "id": "b695614a-52ec-4835-9e13-bdf5ff4c7448",
                "type": "Role"
            },
            {
                "id": "11f87dac-027f-4d76-bd29-1ea1536b93da",
                "type": "Role"
            }
        ]
    }
],

Wartość	Opis
Scope	Ten dostęp do zasobów jest definiowany do korzystania z zakresu uprawnień delegowanych.
Rola	Ten dostęp do zasobów jest definiowany do korzystania z zakresu uprawnień aplikacji.
da9b70f6-5323-4ce6-ae5c-88dcc5082966	Identyfikator usługi Universal Print w chmurze globalnej platformy Azure.
3e306194-d6c5-43ad-afbb-0e7b16a9c10b	Identyfikator uprawnienia Drukarki.Create.
1c90a3a7-465b-49c4-adcc-c8ac83d3d3f8	Identyfikator uprawnienia PrinterProperties.ReadWrite.
2b1bdd6b-9a0f-47c6-a806-b3e20cfd07a8	Identyfikator uprawnienia Drukarki.Read.
b695614a-52ec-4835-9e13-bdf5ff4c7448	Identyfikator uprawnienia PrintJob.Read.
11f87dac-027f-4d76-bd29-1ea1536b93da	Identyfikator uprawnienia PrintJob.ReadWriteBasic.

• Zapisz zmiany.