Merge pull request #9673 from backstage/server-permission-client-error

[Permissions] Improve error message for backend-to-backend authn setup

.changeset/serious-eyes-fix.md

@@ -0,0 +1,5 @@
+---
+'@backstage/plugin-permission-node': patch
+---
+
+Improved error message shown when permissions are enabled without backend-to-backend authentication.

plugins/permission-node/src/ServerPermissionClient.test.ts

@@ -113,7 +113,7 @@ describe('ServerPermissionClient', () => {
         tokenManager: ServerTokenManager.noop(),
       }),
     ).toThrowError(
-      'You must configure at least one key in backend.auth.keys if permissions are enabled.',
+      'Backend-to-backend authentication must be configured before enabling permissions. Read more here https://backstage.io/docs/tutorials/backend-to-backend-auth',
     );
   });
 });

plugins/permission-node/src/ServerPermissionClient.ts

@@ -56,7 +56,7 @@ export class ServerPermissionClient implements PermissionAuthorizer {
       (tokenManager as any).isInsecureServerTokenManager
     ) {
       throw new Error(
-        'You must configure at least one key in backend.auth.keys if permissions are enabled.',
+        'Backend-to-backend authentication must be configured before enabling permissions. Read more here https://backstage.io/docs/tutorials/backend-to-backend-auth',
       );
     }