[Security/APIKey Service] Internal API endpoint do determine if user has API keys

x-pack/plugins/security/server/routes/api_keys/has.test.ts

@@ -0,0 +1,125 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import Boom from '@hapi/boom';
+
+import { kibanaResponseFactory } from '@kbn/core/server';
+import type { RequestHandler } from '@kbn/core/server';
+import type { CustomRequestHandlerMock, ScopedClusterClientMock } from '@kbn/core/server/mocks';
+import { coreMock, httpServerMock } from '@kbn/core/server/mocks';
+import { licensingMock } from '@kbn/licensing-plugin/server/mocks';
+import type { DeeplyMockedKeys } from '@kbn/utility-types-jest';
+
+import { defineHasApiKeysRoutes } from './has';
+import type { InternalAuthenticationServiceStart } from '../../authentication';
+import { authenticationServiceMock } from '../../authentication/authentication_service.mock';
+import { routeDefinitionParamsMock } from '../index.mock';
+
+describe('Has API Keys route', () => {
+  let routeHandler: RequestHandler<any, any, any, any>;
+  let authc: DeeplyMockedKeys<InternalAuthenticationServiceStart>;
+  let esClientMock: ScopedClusterClientMock;
+  let mockContext: CustomRequestHandlerMock<unknown>;
+
+  beforeEach(async () => {
+    const mockRouteDefinitionParams = routeDefinitionParamsMock.create();
+    authc = authenticationServiceMock.createStart();
+    mockRouteDefinitionParams.getAuthenticationService.mockReturnValue(authc);
+    defineHasApiKeysRoutes(mockRouteDefinitionParams);
+    [[, routeHandler]] = mockRouteDefinitionParams.router.get.mock.calls;
+    mockContext = coreMock.createCustomRequestHandlerContext({
+      core: coreMock.createRequestHandlerContext(),
+      licensing: licensingMock.createRequestHandlerContext(),
+    });
+
+    esClientMock = (await mockContext.core).elasticsearch.client;
+
+    authc.apiKeys.areAPIKeysEnabled.mockResolvedValue(true);
+    authc.apiKeys.areCrossClusterAPIKeysEnabled.mockResolvedValue(true);
+
+    esClientMock.asCurrentUser.security.getApiKey.mockResponse({
+      api_keys: [
+        { id: '123', invalidated: false },
+        { id: '456', invalidated: true },
+      ],
+    } as any);
+  });
+
+  it('should calculate when user has API keys', async () => {
+    const response = await routeHandler(
+      mockContext,
+      httpServerMock.createKibanaRequest(),
+      kibanaResponseFactory
+    );
+
+    expect(response.payload).toEqual(
+      expect.objectContaining({
+        hasApiKeys: true,
+      })
+    );
+  });
+
+  it('should calculate when user does not have API keys', async () => {
+    esClientMock.asCurrentUser.security.getApiKey.mockResponse({
+      api_keys: [],
+    });
+
+    const response = await routeHandler(
+      mockContext,
+      httpServerMock.createKibanaRequest(),
+      kibanaResponseFactory
+    );
+
+    expect(response.payload).toEqual(
+      expect.objectContaining({
+        hasApiKeys: false,
+      })
+    );
+  });
+
+  it('should filter out invalidated API keys', async () => {
+    const response = await routeHandler(
+      mockContext,
+      httpServerMock.createKibanaRequest(),
+      kibanaResponseFactory
+    );
+
+    expect(response.status).toBe(200);
+    expect(response.payload?.hasApiKeys).toBe(true);
+  });
+
+  it('should return `404` if API keys are disabled', async () => {
+    authc.apiKeys.areAPIKeysEnabled.mockResolvedValue(false);
+
+    const response = await routeHandler(
+      mockContext,
+      httpServerMock.createKibanaRequest(),
+      kibanaResponseFactory
+    );
+
+    expect(response.status).toBe(404);
+    expect(response.payload).toEqual({
+      message:
+        "API keys are disabled in Elasticsearch. To use API keys enable 'xpack.security.authc.api_key.enabled' setting.",
+    });
+  });
+
+  it('should forward error from Elasticsearch GET API keys endpoint', async () => {
+    const error = Boom.forbidden('test not acceptable message');
+    esClientMock.asCurrentUser.security.getApiKey.mockResponseImplementation(() => {
+      throw error;
+    });
+
+    const response = await routeHandler(
+      mockContext,
+      httpServerMock.createKibanaRequest(),
+      kibanaResponseFactory
+    );
+
+    expect(response.status).toBe(403);
+    expect(response.payload).toEqual(error);
+  });
+});

x-pack/plugins/security/server/routes/api_keys/has.ts

@@ -0,0 +1,65 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+
+import type { RouteDefinitionParams } from '..';
+import { wrapIntoCustomErrorResponse } from '../../errors';
+import { createLicensedRouteHandler } from '../licensed_route_handler';
+
+/**
+ * Response of Kibana Has API keys endpoint.
+ */
+export interface HasAPIKeysResult {
+  hasApiKeys: boolean;
+}
+
+export function defineHasApiKeysRoutes({
+  router,
+  getAuthenticationService,
+}: RouteDefinitionParams) {
+  router.get(
+    {
+      path: '/internal/security/has_api_keys',
+      validate: false,
+      options: {
+        access: 'internal',
+      },
+    },
+    createLicensedRouteHandler(async (context, _request, response) => {
+      try {
+        // copied logic from get.ts
+        const esClient = (await context.core).elasticsearch.client;
+        const authenticationService = getAuthenticationService();
+
+        const areApiKeysEnabled = await authenticationService.apiKeys.areAPIKeysEnabled();
+
+        if (!areApiKeysEnabled) {
+          return response.notFound({
+            body: {
+              message:
+                "API keys are disabled in Elasticsearch. To use API keys enable 'xpack.security.authc.api_key.enabled' setting.",
+            },
+          });
+        }
+
+        const apiResponse = await esClient.asCurrentUser.security.getApiKey({
+          owner: true,
+        });
+
+        const validKeys = apiResponse.api_keys.filter(({ invalidated }) => !invalidated);
+
+        // simply return true if the result array is non-empty
+        return response.ok<HasAPIKeysResult>({
+          body: {
+            hasApiKeys: validKeys.length > 0,
+          },
+        });
+      } catch (error) {
+        return response.customError(wrapIntoCustomErrorResponse(error));
+      }
+    })
+  );
+}

x-pack/plugins/security/server/routes/api_keys/index.ts

@@ -8,6 +8,7 @@
 import { defineCreateApiKeyRoutes } from './create';
 import { defineEnabledApiKeysRoutes } from './enabled';
 import { defineGetApiKeysRoutes } from './get';
+import { defineHasApiKeysRoutes } from './has';
 import { defineInvalidateApiKeysRoutes } from './invalidate';
 import { defineUpdateApiKeyRoutes } from './update';
 import type { RouteDefinitionParams } from '..';
@@ -24,6 +25,7 @@ export type { GetAPIKeysResult } from './get';
 export function defineApiKeysRoutes(params: RouteDefinitionParams) {
   defineEnabledApiKeysRoutes(params);
   defineGetApiKeysRoutes(params);
+  defineHasApiKeysRoutes(params);
   defineCreateApiKeyRoutes(params);
   defineUpdateApiKeyRoutes(params);
   defineInvalidateApiKeysRoutes(params);

x-pack/test_serverless/api_integration/test_suites/common/platform_security/api_keys.ts

@@ -163,6 +163,31 @@ export default function ({ getService }: FtrProviderContext) {
           expect(status).toBe(200);
         });
 
+        it('has_api_keys', async () => {
+          let body: unknown;
+          let status: number;
+
+          ({ body, status } = await supertest
+            .get('/internal/security/has_api_keys')
+            .set(svlCommonApi.getCommonRequestHeader()));
+          // expect a rejection because we're not using the internal header
+          expect(body).toEqual({
+            statusCode: 400,
+            error: 'Bad Request',
+            message: expect.stringContaining(
+              'method [get] exists but is not available with the current configuration'
+            ),
+          });
+          expect(status).toBe(400);
+
+          ({ body, status } = await supertest
+            .get('/internal/security/has_api_keys')
+            .set(svlCommonApi.getInternalRequestHeader()));
+          // expect success because we're using the internal header
+          expect(status).toBe(200);
+          expect(body).toEqual({ hasApiKeys: true });
+        });
+
         it('invalidate', async () => {
           let body: unknown;
           let status: number;